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Chapter 1: Preliminary Information 



If you need to contact us: 



Address: MetaLink Corporation 

P.O. BOX 1329 
Chandler, AZ 85244-1329 
U.SA. 



For Customer or Technical Assistance: 



Phone: (800) METAICE 

(800) 638-2423 
(602) 926-0797 



Fax: (602) 926-1198 

Telex: 4998050 MTLNK 
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Warranty Information 







MetaLink Corporation makes no warranties other than those contained herein and MetaLink Corpora- 
tion expressly disclaims any and all warranties of fitness for a particular purpose. 



Disclaimer of Ail Warranties and Liability 



MetaLink Corporation makes no warranties, either expressed or implied, with respect to this manual or 
with respect to the software described in this manual, its quality, performance, merchantability or fitness 
for any particular purpose. MetaLink Corporation software is sold or licensed "as is". In no event shall 
MetaLink Corporation be liable for incidental or consequential damages resulting from any defect in the 
software. 



Limited Warranty 



The following limited warranties shall apply: 

Emulators All electronics of MetaLink emulators are guaranteed against defects due to materials or workmanship 
for a ninety (90) day period from the invoice date. For registered iceMASTER units this period is 
extended to one (1) year from the invoice date. MetaLink emulators contain no user-serviceable compo- 
nents. This warranty is voided and any unpaid balance is due immediately if an emulator chassis has 
been damaged or opened for any reason. 

Emulator The iceMASTER emulator's probe assembly is guaranteed against defects due to materials or workman- 
Probe ship for a ninety (90) day period from the invoice date. For registered iceMASTER units this period is 
Assemblies extended to one (1) year from the invoice date. This warranty does not include damage to the pins of the 
probe assembly. Some MetaLink probe assemblies are shipped with a special "Bondout" version of a 
device. MetaLink's warranty of this special device is limited to that of the manufacturer. 

Unauthorized No warranty extended by MetaLink shall apply to any goods which have been modified or altered by 
Service persons other than MetaLink's authorized personnel; to goods that are defective due to misuse, neglect, 

improper installation, soldering or accident; or to goods sold as "used". 

Payment The foregoing limited warranties shall not apply unless Buyer has paid in full for the MetaLink products. 

Requirement Updates to the emulator User's Manual and emulator Host Software are available free to Buyer upon 

request for a ninety (90) day period from the invoice date. For registered iceMASTER units, this period 

is extended to a one-year-period from the invoice date. 



Controlling Law 



MetaLink Corporation does business and is located solely in the state of Arizona. All orders or agree- 
ments and the rights of the parties hereunder shall be governed by the laws of the state of Arizona. 
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Liability 



MetaLink's liability hereunder is expressly limited, at MetaLink's option, to either: 

1) the repair or replacement of the iceMASTER emulator that meets MetaLink's Limited Warranty, 
or 

2) to a credit to Buyer in an amount equal to the Purchase Price of the iceMASTER emulator. 

In no event shall MetaLink Corporation be liable for any incidental or consequential damages, losses 
or expenses directly or indirectly arising from the sale, handling, installation or use of MetaLink 
Corporation products or from any other cause related thereto. 

Restocking Charge 



A restocking charge of 15% of the purchase price will be charged on all units returned within the ninety 
(90) day warranty period. Units being returned beyond the ninety (90) day warranty will have a negotiated 
restocking charge. 

Extended Warranty 



MetaLink offers an extended warranty. The above limited warranty terms may be extended beyond the 
ninety (90) day period for non-registered users or the one (1) year period for registered users, under our 
extended warranty program. You may purchase extensions in one-year-increments for a nominal fee, 
provided your unit is currently under warranty. If your warranty has expired, there will be a service fee to 
check out your unit and repair it, if necessary, before accepting the unit for extended coverage. Please 
contact MetaLink for more information and pricing. 

Owner Registration 



As you unpack your iceMASTER emulator take a moment to fill out and return the postage prepaid 
owner registration card. This card is located with the Host Software and Probe Card Software diskettes 
in the vinyl jacket at the front of this manual. It is very important that you return a completed card to us. 
This entitles you to extend the normal ninety (90) day warranty to one (1) year. Information from owner 
registration cards is used to distribute software revisions during the warranty period. Registered owners 
will be notified of any hardware upgrades, new products or product enhancements as they become 
available. We cannot be responsible for lost or misdirected registration cards, so please call us if you 
cannot find the card in your manual. We also suggest that you contact us about two weeks after returning 
the registration card to be sure we have received it. 

Upgrade Policy 



Any previously purchased MetaLink emulator may be upgraded to the iceMASTER series of emulators. 
Contact MetaLink (page 1-1) for details. 
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Warning 



The MetaLink emulator has been shipped with the probe assembly inserted in a precision DIP, PLCC, 
or PGA socket with hardened pins, or with some similar method of protecting the pins of the probe 
assembly. We suggest that you protect the probe pin assembly at all times, even when in use. (When 
inserted in a target system the target socket should be capable of protecting the probe assembly pins). 
Failure to protect the pins of the probe assembly could result in a damaged and unusable probe 
assembly. 

THE PROBE PINS ARE NOT COVERED UNDER THE METALINK CORPORATION EMULATOR 
WARRANTY. 
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Chapter 2: Introduction 



About This Manual 



The information presented in this manual applies only to the Host Software version 3.0 revision 12 and 
the iceMASTER series of products. Statements found in this manual should not be applied to earlier 
software or hardware products other than those specified in the warranty. If you have an earlier version 
of either the Host Software, manual or hardware, do not mix versions. Each version has many unique 
features and may not be compatible with similar products. 

The manual is organized into several sections which include: 

Preliminary Information contains important copyright, trademark, and warranty information, handling 
information, owner registration and upgrade information and the table of contents. 

Introduction which you are now reading, contains a description of each section of the manual as well as 
other information to get you started. 

Hardware Installation contains a description of the hardware and how to install it. 

Probe Card Reference contains detailed information about each probe card including jumper configura- 
tion and available modes of operation. 

Software Installation contains information and requirements for installing the software on your hard disk. 

Software Guide contains a description of the terminology used in the manual, explains the layout of the 
screen and a description of the features of the Host Software. 

Command Reference contains information on how to use each command in the Host Software. 

Run-Time Considerations contains a description of some things to be aware of while working in an 
emulation environment. 

Troubleshooting contains a description of what to look for and how to go about it should problems arise. 

Appendices contain various topics related to the emulator, the Host Software, the Host Computer and 
the Tutorial. 

This manual will show you how to use the iceMASTER emulator with your PC. This combination of 
iceMASTER and the PC is a powerful engineering development system. 
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The Emulator 



The iceMASTER emulator is an in-circuit emulator controlled by an IBM PC (or compatible) running 
the PC-DOS/MS-DOS operating system. The iceMASTER emulator is an integral part of the develop- 
ment engineer's toolbox, with application in software development, hardware integration, manufacturing 
test and field service. 

The emulator can be operated in a target system in place of the microcontroller, or independently in stand 
alone mode. Stand alone mode allows you to emulate hardware and/or execute code without a target 
system (provided no interaction with external devices is needed). 

Hardware designers may use the emulator to develop and debug their designs. All available features of a 
given device are accessible interactively, as well as through user programs. Software designers have 
complete emulation capability as well. The emulator will execute your code just like the real part because 
it uses the real part for emulation. 



Recommended References 



Several additional references can be of help to you as you progress through the development process. The 
DOS reference guide for the version of DOS you are using provides helpful information on filename 
conventions and batch files. Batch files provide a simple method for invoking the Host Software with a 
minimum of effort. The data book and programmer's guide for the microcontroller you are using provide 
essential information. You will also need the programmer's manual for the development language you are 
using. 



What You Need To Know 



Throughout this manual it is presumed that you have a working knowledge of: 

1) the family of microcontrollers you are emulating 

2) the IBM PC (or compatible) as an engineering tool 

3) a development language (Assembly Language, PL/M, or C) 

4) IBM PC-DOS or Microsoft MS-DOS 

A few of these topics are discussed in this manual as a means of illustrating a particular feature or facet 
of the iceMASTER emulator's abilities; however, basic programming knowledge and familiarity with the 
microcontroller architecture are assumed. 

Getting Started 



If you have not already done so, you should now read the warranty information (Chapter 1). From here 
you should perform the Hardware Installation (Chapter 3) and Software Installation (Chapter 5). Once 
the installation process is complete, we recommend you then read the Software Guide (Chapter 6) and 
then work through the Tutorial (Appendix A). 
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MetaLink iceMASTER emulators are compact, modular assemblies. Each subassembly is detachable by 
use of a mating connector. The subassemblies are: 

1) iceMASTER emulator base chassis 

2) Probe card 

3) Probe card cable 

4) Probe clip assembly 

5) Power supply with cable (you may elect to furnish your own power supply) 

Installation 



Connect the 50 pin flat cable to both the emulator and the probe card. You should never turn the power 
to the emulator base on with the probe card disconnected! 

Connect the RS-232 cable to the emulator and to the Host Computer. Be sure you are using Comm Port 
1 or 2. 

Connect the power supply to the emulator by inserting the power supply's connector into the emulator 
power receptacle. For safety, we recommend that all items in your system, including emulator, Host 
Computer and target, be connected to the same outlet. Different outlets though near one another may be 
connected to different circuits resulting in large potential differences between grounds. 

Connect the probe clip assembly. (Optional). 

At this time you should refer to the Probe Card Reference (Chapter 4) to locate the probe card you are 
installing. There are only a few basic functions requiring selection. Most of these are common to all of the 
MetaLink probe cards, though a few are probe card specific. Each probe card type has an illustration 
showing where the jumpers are located for that probe card and the page opposite the probe card 
illustration explains what each jumper selection does. 

If you are going to use the probe card in a stand alone configuration with no target system attached, you 
need to set the XTAL jumpers to PC so that you are using the on-board oscillator. If you intend to follow 
the Tutorial (Appendix A), you should set all the jumpers to their default setting. After completing the 
Tutorial, you may change the settings to fit your application. 

Before you proceed, please take a moment to familiarize yourself with the hardware and its controls. We 
especially recommend that you thoroughly understand the function of each jumper selection for future 
reference. 
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RS-232 Interface 
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Figure 3-1. RS-232 Interface 



The communication link to the Host Computer is based on the serial RS-232C specification. The serial 
baud rates are established entirely under Host Software control, so no adjustment is necessary to your 
serial ports baud rate. We neither use these pre-sets nor change them in any way. 

The cable mates via a 25-pin male DB-25 connector on the cable at the emulator end. At the host end, the 
mating connector on the cable may be a 25-pin female DB-25 connector for the PC/XT type Host 
Computer or a 9-pin female DB-9 connector for the AT type Host Computer. A 25-pin cable is provided 
with the emulator. Adaptors are available to connect to 9-pin D connectors. Note that Pins 2 and 3 are 
reversed from their normal 25-pin D connector assignments in the 9-pin RS-232C interface of the PC AT. 
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Probe Card Cable 



Flat Cable: 3M #3365/50 or equivalent. 



T T 
1 — 50 Pin Connector: 3M #3425-6600 or equivalent. — 1 



Figure 3-2. Probe Card Cable 



On the probe card cable, IDC connectors mate with 50-pin ejector headers at either end for quick, easy 
assembly and disassembly of the emulator's primary parts. The ribbon cable can be reversed end-for-end 
with no difficulty, however, we recommend that you leave the red stripe denoting pin one to the right of 
the probe card's connector and to the left of the emulator base's connector, to avoid confusion later. 



Probe Card Protection 



It is advisable to use a high-quality DIP, PGA or PLCC socket (as appropriate) at all times to protect the 
hardened machined pins of the probe card. The machined pins of the probe card are not easily replaced 
nor are they covered by the warranty. 
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Emulator Chassis 



green 



red 




-232 DB-25 Female Connector 



Figure 3-3. Emulator ( 



Switches Three switches are provided on the emulator chassis, as follows: 

1) The rocker switch on the left side-panel is for Power. 

2) The push-button labeled Reset, on top of the emulator, allows you to reset the probe card. Unless 
there is an independent reset-out signal provided by the microcontroller, there is no reset provided 
by this switch for your target system. If you require such a target system reset, you must provide it. 
Reset inputs to the microcontroller are valid. 

3) Activating the push-button labeled Break, puts the emulator into Break condition. That is, it halts 
execution of your code and places you in interactive mode in the Host Software. 
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1) The red LED, labeled Power, is lit when power is applied to the emulator. 

2) The green LED, labeled Active, is lit to indicate that ALE is strobing and will normally be ON unless 
the power-saving CMOS modes of operation are invoked. 

3) The amber LED, labeled Reset, is lit when Reset is active. The Reset and Active LEDs are mutually 
exclusive. Only one should be active (ON) at a time, but if one of the 8051 family special modes is 
active, such as Idle or Power-down, it is normal for both LEDs to be OFF. 

4) The red LED, labeled Break, will be ON when the emulator is in Break condition (interactive 
mode). 

5) The green LED, labeled Emulate, will be ON when the emulator is in Emulation condition (user 
code is running). 
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Probe Clip Assembly 
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14-Position Socket Connector: 3M 3385-6000 or equivalent 

14-Conductor Flat Cable: Belden 9P.28014 or equivalent 

(maximum length=12 in./30 cm.) 

Test Clip, 13 Pieces: Pomona Test Type 4743 or equivalent 




Probe 8 
Line 



Probe Card 

Figure 3-4. Probe Clip Assembly 
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The Probe Clip Assembly can be installed at your option. It is composed of seven input signal lines, four 
ground lines, one Trigger Output line, and one Break Input line. 

The 14-pin female connector plugs in with the keying mark on the connector body-oriented to the 
silk-screened B at the corner of the male header on the Probe Card. 

Input Signal There are seven user-selectable probe clip input signal lines which are inputs to a 74LS245 device on the 
Lines (CLIPS) probe card. These seven probe clip input signal lines can be used to select any TTL-level signal and record 
its state, once each cycle at a time corresponding to the falling edge of #PSEN (or where that signal would 
occur if it were present when operating in a ROM mode. These states are recorded in the trace buffer 
(see the Break/Trace \ View Trace command on page 7-65 for Model 400 Emulators only). 

Probe clip is oriented as shown. 

Break Input The Break Input signal is interfaced via a 74ACT245 device on the probe card. The Break Input is pulled 
Signal (B) up with a 2K ohm pull-up resistor. When this input is pulled low, the emulation cycle will break. The Break 
Input must remain active (LOW) for at least one instruction cycle. 



Trigger Output The Trigger Output signal is interfaced via a 74ACT245 device on the probe card. The Trigger Output 
Signal (T) signal is normally HIGH and will strobe LOW (active) every time the Program Counter passes a Trace 

ON point (see the Break/Trace \ Set \Add \ TRON command on page 7-58 for Model 400 Emulators only). 

The Trigger Output will remain active for a minimum of one instruction cycle (until the next Opcode 

Fetch). Thus, for an instruction which uses two or more instruction cycles to complete, the Trace ON signal 

will remain active for that time. 
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Power Connector 




1 — Nat Connected 

Figure 3-5. Power Connector (on emulator) 



Power is supplied with a standard DIN audio connector similar to the keyboard connector found in many 
PC's. The power supply must provide + 5 volts + /- 5%, at 1.5 amperes. The ripple voltage must be no 
greater than 50 millivolts, peak-to-peak. 
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Chapter 4: Probe Card Reference 



MetaLink emulator probe cards provide a number of user-selectable options via jumper blocks on the 
probe cards. The following pages depict each target probe card and show the relative location of each 
jumper block. The jumpers must be set in a valid configuration in order for the emulator to function 
correctly. 

The following pages also contain mode information (see the Configure \ Emulator \ Mode command on 
page 7-2) and mapping constraint information (see the Configure \ Code Memory command on page 7-4) 
for each probe card. 



4-1 



8031, 8032, 8344, 80C51FA, 80C154, 80C321, 80C652, 80C851 and 80CL410 
Probe Cards 



C/N 



XTAL 



PC 



TAR 



NORM 



DEVICE 



XTAL1 



XTAL2 




50-Pin 

Cable 

Header 



8031,8032,8344,80C51FA,80C154,80C321,80CL410,80C652,80C851 



XTAL (Oscillator) Selection Jumper Block 

PC: Probe card's crystal is used. 

TAR: Target system supplies crystal or external clock. 

This is a double jumper to ensure correct configuration. The center post is the common post. 
The LEFT side of the jumper block connects to XTAL 2 input. 
The RIGHT side of the jumper block connects to XTAL 1 input. 
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C/N - NORM Jumper Block 



These two jumpers must always be set to the same relative position, either to C/N or NORM. The only 
time that the two C/N - NORM jumpers are in the C/N position is when the emulator is applied to a target 
built for an NMOS device and the user is using an external clock driver. At all other times, this jumper 
should be in the NORM position. 

XTAL1 - XTAL2 Jumper Block 



The XTAL1-XTAL2 jumper is set in the XTAL1 position only if an NMOS probe card is used in a target 
built for a CMOS controller that uses an external clock driver. At all other times, this jumper must be in 
the XTAL2 position. See the Map of Clock Jumpers at the end of this chapter (page 4-42). 

Note that early versions of these probe cards were labeled DRIVER - XTAL. For these probe cards, 
DRIVER corresponds to XTAL1. 

VCC (Device VCC) Jumper 



The VCC jumper on this device is set at the factory to supply a VCC of + 5V from the probe card. This 
jumper is not user selectable and must not be changed. 

Device Orientation 



The probe card is supplied with a probe head that has a DIP footprint connection for the target system. 
Pin one orientation of the DIP socket can be determined by viewing the probe head from the cable header 
(component) side. Pin one is in the lower right corner near the printed Pin one on the circuit board. 

80C321 Modes Of Operation 



Mode 1: Watchdog Timer Off 

This is the default mode. In this mode of operation the assumption is made that your application code will 
not enable the Watchdog Timer. If your application does enable the Watchdog Timer while in this mode 
it is possible that a Watchdog Timer Reset may occur while the emulator is in break condition. If the 
Watchdog Timer Reset occurs the state of the device at that time will be lost. 

Mode 2; Watchdog Timer On 

In this mode of operation the assumption is made that your application code has enabled the Watchdog 
Timer. While in break condition in this mode, the emulator executes the code necessary to refresh the 
Watchdog Timer to prevent a Watchdog Timer Reset from occurring. Of course, while in emulation 
condition your application code is responsible for refreshing the Watchdog Timer. 
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8052 Probe Card 
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PC: Probe card's crystal is used. 

TAR: Target system supplies crystal or external clock. 



This is a double jumper to ensure correct configuration. The center post is the common post. 
The LEFT side of the jumper block connects to XTAL 2 input. 
The RIGHT side of the jumper block connects to XTAL 1 input. 
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EA (External Address) Selection Jumper Block 



VCC: Emulator controls EA pin (EA = HIGH = + 5V) as ROM device. 

GND: Emulator controls EA pin (EA = LOW = OV) as ROMless device. 
TAR: Target system controls EA pin. 

Note that if you intend to use more than the amount of memory available in internal ROM, that is, if you 
intend to use this probe card in Rollover, you must configure the EA jumper to GND, and operate in 
ROMless mode (as you will be doing after Rollover). 

NMOS - CMOS Jumper Block 



The 8052 probe card is based on a CMOS controller. The only situation that would be "out of the ordinary" 
would be the use of an NMOS controller circuit with an external clock driver. In this case, the CMOS - 
NMOS jumpers should be set to the NMOS position. At all other times the jumpers should be set to the 
CMOS position. See the Map of Clock Jumpers at the end of this chapter (page 4-43). 

VCC (Device VCC) Jumper 



The VCC jumper on this device is set at the factory to supply a VCC of + 5V from the probe card. This 
jumper is not user selectable and must not be changed. 

Device Orientation 



The 8052 probe card is supplied with a probe head that has a DIP footprint connection for the target 
system. Pin one orientation of the DIP socket can be determined by viewing the probe head from the cable 
header (component) side. Pin one is in the lower right corner near the printed Pin one on the circuit board. 

8052 Modes Of Operation 



Mode 1: ROMless (803X^ Operation. /EA = Low 

In this mode of operation, the emulator is configured to operate as a ROMless version of the 
microcontroller. The EA jumper must be set LOW. All code memory fetches are external. There are no 
mapping constraints in this mode. 

Mode 2: ROM (805X). /EA = Hig h 

This is the default mode. In this mode of operation, the emulator is configured to operate as a ROM 
version of the microcontroller. The EA jumper must be set HIGH. Code memory fetches within the ROM 
address space (0 through 16K) are internal and there is no access to code memory outside of the ROM 
address space so there can be no external code memory fetches. The ROM address space in code memory 
must be mapped to the emulator in this mode. 
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83C053 Probe Card 
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83C053 Probe Card 



XTAL (Oscillator) Selection Jumper Block 




PC: Probe card's crystal is used. 

TAR: Target system supplies crystal or external clock. 



This is a double jumper to ensure correct configuration. The center post is the common post. 
The LEFT side of the jumper block connects to XTAL 2 input. 
The RIGHT side of the jumper block connects to XTAL 1 input. 
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Device Orientation 



The 83C053 probe card is supplied with a probe head that has a DIP footprint connection for the target 
system. Pin one orientation of the DIP socket can be determined by viewing the probe head from the cable 
header (component) side. Pin one is in the lower right corner of the device. Note that the target board 
connector is not directly under the DIP socket on the top side of the probe card circuit board. Pin 1 on 
the target board connector is at the lower left. 
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83C152 Probe Card 
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83C152 Probe Card 



XTAL (Oscillator) Selection Jumper Block 



PC: Probe card's crystal is used. 

TAR: Target system supplies crystal or external clock. 

This is a double jumper to ensure correct configuration. The center post is the common post. 
The LEFT side of the jumper block connects to XTAL 2 input. 
The RIGHT side of the jumper block connects to XTAL 1 input. 
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VCC (Device VCC) Selection Jumper Block 



PC: Probe card supplies a VCC of + 5V. 

TAR: Target system supplies VCC. 

EA (External Address) Selection Jumper Block 



+ 5: Emulator controls EA pin (EA = HIGH = +5V) as ROM device. 

0: Emulator controls EA pin (EA = LOW = 0V) as ROMless device. 

TAR: Target system controls EA pin. 

RD (Read Signal) Control Jumper Block 



+ 5: Port 3.7 is an Input/Output pin. 

/RD: Port 3.7 is used as Read Signal pin. 

/WR (Write Signal) Control Jumper Block 



+ 5: Port 3.6 is an Input/Output pin. 

/WR: Port 3.6 is used as Write Signal pin. 

Device Orientation 



The 83C152 Probe card is supplied with a probe head that has a PLCC footprint connection for the target 
system. Pin one orientation of the PLCC socket can be determined by viewing the probe head from the 
cable header connector side. Pin one is on the upper side near the XTAL and VCC jumper blocks on the 
board. 

83C152 Modes Of Operation 

Mode 1: ROMless Operation, /EA = Low 

In this mode of operation, the emulator is configured to operate as a ROMless version of the 
microcontroller. The EA jumper must be set LOW. All code memory fetches are external. There are no 
mapping constraints in this mode. 

Mode 2: ROM Operation, /EA = High 

This is the default mode. In this mode of operation, the emulator is configured as a ROM version of the 
microcontroller. The EA jumper must be set HIGH. Code memory fetches within the ROM address 
space (0 through 8K) are internal and code memory fetches outside the ROM boundary are external. The 
ROM address space in code memory must be mapped to the emulator in this mode. 
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80C451 Probe Card 
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PC: Probe card's crystal is used. 

TAR: Target system supplies crystal or external clock. 

This is a double jumper to ensure correct configuration. The center post is the common post. 
The LEFT side of the jumper block connects to XTAL 2 input. 
The RIGHT side of the jumper block connects to XTAL 1 input. 
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VCC (Device VCC) Selection Jumper Block 



PC: Probe card supplies a VCC of + 5V. 

TAR: Target system supplies VCC. 



Device Orientation 




The 80C451 probe card is supplied with a probe head that has a PLCC footprint connection for the target 
system. Pin one side orientation of the PLCC can be determined by viewing the probe head from the cable 
header (component) side. Pin one is on the side opposite the cable header. 
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83C451 Probe Card 
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83C451 Probe Card 



XTAL (Oscillator) Selection Jumper Block 



PC: Probe card's crystal is used. 

TAR: Target system supplies crystal or external clock. 

This is a double jumper to ensure correct configuration. The center post is the common post. 
The LEFT side of the jumper block connects to XTAL 2 input. 
The RIGHT side of the jumper block connects to XTAL 1 input. 
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VCC (Device VCC) Selection Jumper Block 



PC: Probe card supplies a VCC of + 5V. 

TAR: Target system supplies VCC. 

EA (External Address) Selection Jumper Block 



+ 5: Emulator controls EA pin (EA = HIGH = + 5V) as ROM device. 

0: Emulator controls EA pin (EA = LOW = 0V) as ROMless device 

TAR: Target system controls EA pin. 

Device Orientation 



The 83C451 probe card is supplied with a probe head that has a PLCC footprint connection for the target 
system. Pin one orientation of the PLCC socket can be determined by viewing the probe head from the 
cable header connector side. Pin one is on the side opposite the cable header. 

83C451 Modes Of Operation 



Mode 1: ROMless (80C451) Operation, /EA = Low 

In this mode of operation, the emulator is configured to operate as a ROMless version of the 
microcontroller. The EA jumper must be set LOW. All code memory fetches are external. There are no 
mapping constraints in this mode. 

Mode 2: ROM (83C451), /EA = High 

This is the default mode. In this mode of operation, the emulator is configured to operate as a ROM 
version of the microcontroller. The EA jumper must be set HIGH. Code memory fetches within the ROM 
address space (0 through 4K) are internal and there is no access to code memory outside of the ROM 
address space so there can be no external code memory fetches. The ROM address space in code memory 
must be mapped to the emulator in this mode. 
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80C517 Probe Card 




80C517 Probe Card 



TSEL (Emulation Device) Selection Jumper Block 



GND: Probe card emulates 80515/80535 or 80C515/80C535 device. 

The bits SD, OWDS and ADEX have no function; the oscillator watchdog is disabled; the 
bit WDTS is set the same way as in the 80515/80535 and 80C515/80C535; the function of pin 
PE#/SWD corresponds to the function of pin PE# in the 80515/80535 and 80C515/80C535 
(i.e., no automatic startup of the watchdog timer). Note that the reading and writing of 
80C517-only SFR's is not suppressed. 

+ 5: Probe card emulates 80C517/80C537 device. 

The bits SD, OWDS, and ADEX have their 80C517/80C537 function; the oscillator 
watchdog can be controlled by pin OWE (its status flag is OWDS); the function of pin 
PE#/SWD corresponds to the function in the 80C517/80C537. 
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XTAL (Oscillator) Selection Jumper Block 



PC: Probe card's crystal is used. 

TAR: Target system supplies crystal or external clock. 

The LEFT side of the jumper block connects to XTAL 2 input. 
The RIGHT side of the jumper block connects to XTAL 1 input. 

Note that if using an external clock source, XTAL2 must be driven and XTALl must be left unconnected. 



VCC (Device VCC) Selection Jumper Block 



PC: Probe card supplies a VCC of + 5V. 

TAR: Target system supplies VCC (power must be supplied at all times). 

Note that the device on the probe card is independently bypassed at each power input regardless of where 
VCC is supplied from. This allows the target system to supply cleaner power for the analog to digital 
converter if necessary. 

EA (External Address) Selection Jumper Block 



+ 5: Emulator controls EA pin (EA = HIGH = +5V) as ROM device (80515, 80C515, 

80C517). 

G: Emulator controls EA pin (EA = LOW = 0V) as ROMless device (80535, 80C535, 

80C537). 

TAR: Target system controls EA pin. 



EMO and EM1 Jumpers 



These jumpers are set at the factory to GND and must not be changed. These jumpers are reserved for 
possible future enhancements to the 80C517 probe card. 



/RD (Read Signal) Control Jumper Block 



+ 5: Port 3.7 is an Input/Output pin. 

/RD: Port 3.7 is used as Read Signal pin. 

Note that the default setting of this jumper should be /RD. However, if Port 3.7 is being used exclusively 
for Input/Output and you are experiencing unpredictable emulator behavior (e.g., spurious breaks, 
undecodable trace) change the jumper setting to +5. 
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/WR (Write Signal) Control Jumper Block 

+ 5: Port 3.6 is an Input/Output pin. 

/WR: Port 3.6 is used as Read Signal pin. 

Note that the default setting of this jumper should be /WR. However, if Port 3.6 is being used exclusively 
for Input/Output and you are experiencing unpredictable emulator behavior (e.g., spurious breaks, 
undecodable trace) change the jumper setting to + 5. 

OWE (Oscillator Watchdog Enable) Jumper Block 



+ 5: OWE enabled. 

GND: OWE disabled. 
TAR: OWE controlled by target system. 

PE#/SWD (Power Saving Mode Enable / Start Watchdog Timer) Jumper 
Block 



+ 5: Disable Power Saving Modes / WDT auto-start at RESET enabled (517 mode only). 

GND: Enable Power Saving Modes / WDT auto-start at RESET disabled (517 mode only). 
TAR: PE#/SWD controlled by target system. 

Device Orientation 



The 80C517 probe card is supplied with a probe head that has a PLCC footprint connection for the target 
system. Pin one side orientation of the PLCC can be determined by viewing the probe head from the cable 
header (component) side. Pin one is on the middle of the top side, as designated. 

Functional Concerns 



When emulating the 80515/80535, pin 37 on the 68 pin PLCC (MHW-CONV10) must be left open. 

Note that since this is an emulation environment, the actual current (Ice) used may be greater than the 
maximum current specified for the device being emulated. 

Note that the 80C517 probe card can be used to emulate the 80515/80535 and 80C515/80C535 devices 
(with a MHW-CONV10 converter) as the 80C517 is essentially a superset of those devices. Unintentional 
activation of 80C517-only functionality while emulating the 80515/80535 or 80C515/80C535 might lead to 
unexpected results. For functionality that is shared, but different, the TSEL jumper (page 4-14) controls 
which device to emulate. 
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80C517 and 80C515 (80C517 with converter) Modes Of Operation 



Mode 1: ROMless (8QC53X ). Wa tchdog Timer Off. /EA a Low 

In this mode of operation, the emulator is configured to operate as a ROMless version of the 
microcontroller. The EA jumper must be set LOW. All code memory fetches are external. There are no 
mapping constraints in this mode. 

In addition, the assumption is made that your application code will not enable the Watchdog Timer. If 
your application does enable the Watchdog Timer while in this mode it is possible that a Watchdog Timer 
Reset may occur while the emulator is in break condition. If the Watchdog Timer Reset occurs the state 
of the device at that time will be lost. 

M ode 2; RO M ( 8QC51X ), Wa tch d og Timer O ff, /EA = Hi gh 

This is the default mode. In this mode of operation, the emulator is configured as a ROM version of the 
microcontroller. The EA jumper must be set HIGH. Code memory fetches within the ROM address 
space (0 through 8K) are internal. Code memory fetches outside the ROM address space are external. 
The ROM area in code memory must be mapped to the emulator. 

In addition, the assumption is made that your application code will not enable the Watchdog Timer. If 
your application does enable the Watchdog Timer while in this mode it is possible that a Watchdog Timer 
Reset may occur while the emulator is in break condition. If the Watchdog Timer Reset occurs the state 
of the device at that time will be lost. 

Mode 3: ROMless (80C53X ), Wa tchdog Timer O n, /EA = Low 

In this mode of operation, the emulator is configured to operate as a ROMless version of the 
microcontroller. The EA jumper must be set LOW. All code memory fetches are external. There are no 
mapping constraints in this mode. 

In addition, the assumption is made that your application code has enabled the Watchdog Timer. While 
in break condition in this mode, the emulator executes the code necessary to refresh the Watchdog Timer 
to prevent a Watchdog Timer Reset from occurring. Of course, while in emulation condition your 
application code is responsible for refreshing the Watchdog Timer. 

Mode 4: ROM (80051X1 Watchdog Timer On. /EA = Hig h 

In this mode of operation, the emulator is configured as a ROM version of the microcontroller. The EA 
jumper must be set HIGH. Code memory fetches within the ROM address space (0 through 8K) are 
internal. Code memory fetches outside the ROM address space are external. The ROM area in code 
memory must be mapped to the emulator. 

In addition, the assumption is made that your application code has enabled the Watchdog Timer. While 
in break condition in this mode, the emulator executes the code necessary to refresh the Watchdog Timer 
to prevent a Watchdog Timer Reset from occurring. Of course, while in emulation condition your 
application code is responsible for refreshing the Watchdog Timer. 
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80C521 Probe Card 
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Pin 1 




80C521 Probe Card 



XTAL (Oscillator) Selection Jumper Block 



PC: Probe card's crystal is used. 

TAR: Target system supplies crystal or external clock. 

This is a double jumper to ensure correct configuration. The center post is the common post. 
The LEFT side of the jumper block connects to XTAL 2 input. 
The RIGHT side of the jumper block connects to XTAL 1 input. 



4-18 



VCC (Device VCC) Jumper 



The VCC jumper on this device is set at the factory to supply a VCC of + 5V from the probe card. This 
jumper is not user-selectable and must not be changed. 

Device Orientation 

The 80C521 probe card is supplied with a probe head that has a DIP footprint connection for the target 
system. Pin one orientation of the DIP socket can be determined by viewing the probe head from the cable 
header (component) side. Pin one is in the upper left corner, as designated. 

Devices Emulated 



The 80C521 probe card will emulate only ROM devices (i.e. 80521, 8051 and 8052). This probe card will 
not emulate ROMless devices (i.e. 8031, 8032 and 80321). You must choose the appropriate probe card, 
80C521 or 80C321, for ROM or ROMless applications, respectively. 

80C521 Modes Of Operation 



Mode 1 : Watchdog Timer Off 

This is the default mode. In this mode of operation the assumption is made that your application code will 
not enable the Watchdog Timer. If your application does enable the Watchdog Timer while in this mode 
it is possible that a Watchdog Timer Reset may occur while the emulator is in break condition. If the 
Watchdog Timer Reset occurs the state of the device at that time will be lost. 

Mode 2: Watchdog Timer On 

In this mode of operation the assumption is made that your application code has enabled the Watchdog 
Timer. While in break condition in this mode, the emulator executes the code necessary to refresh the 
Watchdog Timer to prevent a Watchdog Timer Reset from occurring. Of course, while in emulation 
condition your application code is responsible for refreshing the Watchdog Timer. 
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80C532 and 80C535 Probe Card 
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80C532, 80C535 Probe Cards 



XTAL (Oscillator) Selection Jumper Block 



50-Pin 

Cable 

Header 



PC: Probe card's crystal is used. 

TAR: Target system supplies crystal or external clock. 

This is a double jumper to ensure correct configuration. The center post is the common post. 
The LEFT side of the jumper block connects to XTAL 2 input. 
The RIGHT side of the jumper block connects to XTAL 1 input. 
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VCC (Device VCC) Selection Jumper Block 



PC: Probe card supplies a VCC of + 5V. 

TAR: Target system supplies VCC. 

EA (External Address) Selection Jumper Block 



On the 80C532 and 80C535 probe card, the EA jumper block is not functional; any position may be 
chosen. 

/RD (Read Signal) Control Jumper Block 



+ 5: Port 3.7 is an Input/Output pin. 

/RD: Port 3.7 is used as Read Signal pin. 

/WR (Write Signal) Control Jumper Block 



+ 5: Port 3.6 is an Input/Output pin. 

/WR: Port 3.6 is used as Write Signal pin. 

XTAL - DRVR (External Clock) Jumper Block 



XTAL: Target system supplies crystal clock. 
DRVR: Target system supplies clock drive. 

PE (Power-down Enable) Selection Jumper Block 



VCC: Emulator controls PE pin (PE = HIGH = +5V). 

GND: Emulator controls PE pin (PE = LOW = OV). 
TAR: Target system controls PE pin. 

Device Orientation 



The 80C532 and 80C535 probe cards are supplied with a probe head that has a PLCC footprint connection 
for the target system. Pin one orientation of the PLCC socket can be determined by viewing the probe 
head from the cable header connector side. Pin one is on the side near the cable. 
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Mode 1; Wa tchdog Ti m er O ff 



This is the default mode. In this mode of operation the assumption is made that your application code will 
not enable the Watchdog Timer. If your application does enable the Watchdog Timer while in this mode 
it is possible that a Watchdog Timer Reset may occur while the emulator is in break condition. If the 
Watchdog Timer Reset occurs the state of the device at that time will be lost. 

Mode 2: Watchdog Timer On 

In this mode of operation the assumption is made that your application code has enabled the Watchdog 
Timer. While in break condition in this mode, the emulator executes the code necessary to refresh the 
Watchdog Timer to prevent a Watchdog Timer Reset from occurring. Of course, while in emulation 
condition your application code is responsible for refreshing the Watchdog Timer. 
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80C537 Probe Card 
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80C537 Probe Card 



XTAL (Oscillator) Selection Jumper Block 



50-Pin 

Cable 

Header 



PC: Probe card's crystal is used. 

TAR: Target system supplies crystal or external clock. 

This is a double jumper to ensure correct configuration. The center post is the common post. 
The LEFT side of the jumper block connects to XTAL 2 input. 
The RIGHT side of the jumper block connects to XTAL 1 input. 
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VCC (Device VCC) Selection Jumper Block 



PC: Probe card supplies a VCC of + 5V. 

TAR: Target system supplies VCC. 

EA (External Address) Selection Jumper Block 



In the 80C537 probe card, the EA jumper block is not functional; any position may be chosen. 

/RD (Read Signal) Control Jumper Block 



+ 5: Port 3.7 is an Input/Output pin. 

/RD: Port 3.7 is used as Read Signal pin. 

/WR (Write Signal) Control Jumper Block 



+ 5: Port 3.6 is an Input/Output pin. 

/WR: Port 3.6 is used as Write Signal pin. 

OWE (Oscillator Watchdog Enable) Selection Jumper Block 



+ 5: Emulator controls OWE pin (OWE = HIGH = +5V). 

0: Emulator controls OWE pin (OWE = LOW = 0V). 

TO WE: Target system controls OWE pin. 

PE/SWD (Power Saving Modes) Selection Jumper Block 



+ 5: Emulator controls PE/SWD pin (PE/SWD = HIGH = +5V). 

0: Emulator controls PE/SWD pin (PE/SWD = LOW = 0V). 

TPE/SWD: Target system controls PE/SWD pin. 

Device Orientation 



The 80C537 probe card is supplied with a probe head that has a PLCC footprint connection for the target 
system. Pin one orientation of the PLCC socket can be determined by viewing the probe head from the 
cable header connector side. The Pin one side is the side nearest the cable header. 
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80C537 Modes Of Operation 



Mode L Watchdog Timer Off 

This is the default mode. In this mode of operation the assumption is made that your application code will 
not enable the Watchdog Timer. If your application does enable the Watchdog Timer while in this mode 
it is possible that a Watchdog Timer Reset may occur while the emulator is in break condition. If the 
Watchdog Timer Reset occurs the state of the device at that time will be lost. 

Mode 2: Watchdog Timer On 

In this mode of operation the assumption is made that your application code has enabled the Watchdog 
Timer. While in break condition in this mode, the emulator executes the code necessary to refresh the 
Watchdog Timer to prevent a Watchdog Timer Reset from occurring. Of course, while in emulation 
condition your application code is responsible for refreshing the Watchdog Timer. 
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83C528 Probe Card 



X1X2 



TAR 



PC 



Pin 1 



/EU 



83C528 
DEVICE 




/EA 



B T CLIPS 



/WR 



Hp 



GND 



►5V 



J 



50-Pin 

Cable 

Header 



83C528 Probe Card 



XTAL (Oscillator) Selection 



Block 



PC: Probe card's crystal is used. 

TAR: User's target system supplies crystal or external clock. 

This is a double jumper to ensure correct configuration. 
The center post is the common post. 

The LEFT side of the jumper block connects to XTAL 1 input. 
The RIGHT side of the jumper block connects to XTAL 2 input. 
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EA (External Address) Selection Jumper Block 



GND: Emulator controls EA pin (EA = LOW = OV) as ROMless device. 
+5: Emulator controls EA pin (EA =HIGH = +5V) as ROM device. 

Read Signal Control Jumper Block 



+5: Port 3.7 is an Input/Output pin. 
/RD: Port 3.7 is used as Read Signal pin. 

Write Signal Control Jumper Block 



+5: Port 3.6 is an Input/Output pin. 
/WR: Port 3.6 is used as Write Signal pin. 

/EW (Enable Watchdog) Selection Jumper Block 



In the 83C528 probe card, the EW jumper block is not 
functional; any position may be chosen. 

Device Orientation 



The 83C528 probe card is supplied with a probe head that has 
a DIP or PLCC footprint connection for the target system. 
Pin 1 (one) orientation of the DIP or PLCC socket can be 
determined by viewing the probe head from the bottom 
(interconnect) side. Pin 1 is clearly marked on the adapter 
board. 



NOTE 



The large jumper block array next to the XTAL jumpers is factory preset and should 
not be changed. 
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83C550 Probe Card 
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83C550 Probe Card 



50-Pin 

Cable 

Header 



X1 and X2 (XTAL-Oscillator) Selection Jumper Block 

PC: Probe card's crystal is used. 

TAR: Target system supplies crystal or external clock. 

This is a double jumper to ensure correct configuration. The center post is the common post. 
XI connects to XTAL 1 input. 
X2 connects to XTAL 2 input. 



Note that if using an external clock source, XTAL2 must be driven and XTAL1 must be left unconnected. 



4-28 



VCC (Device VCC) Jumper Block 







The VCC jumper on this device is set at the factory to supply a VCC of + 5V from the probe card. The 
jumper is not user selectable and must not be changed. 

EA (External Address) Selection Jumper Block 

+ 5: Emulator controls EA pin (EA = HIGH = + 5V) as ROM device. 

G: Emulator controls EA pin (EA = LOW = OV) as ROMless device. 

TAR: Target system controls EA pin. 

/RD (Read Signal) Control Jumper Block 

+ 5: Port 3.7 is an Input/Output pin. 

/RD: Port 3.7 is used as Read Signal pin. 

/WR (Write Signal) Control Jumper Block 

+ 5: Port 3.6 is an Input/Output pin. 

/WR: Port 3.6 is used as Read Signal pin. 

Device Orientation 



The 83C550 probe card is supplied with a probe head that has a PLCC footprint connection for the target 
system. Pin one side orientation of the PLCC can be determined by viewing the probe head from the cable 
header (component) side. Pin one is on the middle of the top side, as designated. 
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83C550 Modes Of Operation 



Mode 1; ROMless (80GS50), Watchdog Timer Off, /EA = Low 

In this mode of operation, the emulator is configured to operate as a ROMless version of the 
microcontroller. The EA jumper must be set LOW. All code memory fetches are external. There are no 
mapping constraints in this mode. 

In addition, the assumption is made that your application code will not enable the Watchdog Timer. If 
your application does enable the Watchdog Timer while in this mode it is possible that a Watchdog Timer 
Reset may occur while the emulator is in break condition. If the Watchdog Timer Reset occurs the state 
of the device at that time will be lost. 

Mode 2; ROM (83G55 Q) , Wa tchdog Timer Off, /E A g H igh 

This is the default mode. In this mode of operation, the emulator is configured to operate as a ROM 
version of the microcontroller. The EA jumper must be set HIGH. Code memory fetches within the ROM 
address space (0 through 4K) are internal and there is no access to code memory outside of the ROM 
address space so there can be no external code memory fetches. The ROM address space in code memory 
must be mapped to the emulator in this mode. 

In addition, the assumption is made that your application code will not enable the Watchdog Timer. If 
your application does enable the Watchdog Timer while in this mode it is possible that a Watchdog Timer 
Reset may occur while the emulator is in break condition. If the Watchdog Timer Reset occurs the state 
of the device at that time will be lost. 

Mode 3: ROMless (800.50), Watchdog Timer On, /EA = Low 

In this mode of operation, the emulator is configured to operate as a ROMless version of the 
microcontroller. The EA jumper must be set LOW. All code memory fetches are external. There are no 
mapping constraints in this mode. 

In addition, the assumption is made that your application code has enabled the Watchdog Timer. While 
in break condition in this mode, the emulator executes the code necessary to refresh the Watchdog Timer 
to prevent a Watchdog Timer Reset from occurring. Of course, while in emulation condition your 
application code is responsible for refreshing the Watchdog Timer. 

Mode 4: ROM (8305501 Watchdog Timer On T /EA = High 

In this mode of operation, the emulator is configured to operate as a ROM version of the microcontroller. 
The EA jumper must be set HIGH. Code memory fetches within the ROM address space (0 through 4K) 
are internal and there is no access to code memory outside of the ROM address space so there can be no 
external code memory fetches. The ROM address space in code memory must be mapped to the emulator 
in this mode. 

In addition, the assumption is made that your application code has enabled the Watchdog Timer. While 
in break condition in this mode, the emulator executes the code necessary to refresh the Watchdog Timer 
to prevent a Watchdog Timer Reset from occurring. Of course, while in emulation condition your 
application code is responsible for refreshing the Watchdog Timer. 
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80C552 Probe Card 
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80C552 Probe Card 



XTAL (Oscillator) Selection Jumper Block 



50-Pin 

Cable 

Header 



PC: Probe card's crystal is used. 

TAR: Target system supplies crystal or external clock. 

This is a double jumper to ensure correct configuration. The center post is the common post. 
The LEFT side of the jumper block connects to XTAL 2 input. 
The RIGHT side of the jumper block connects to XTAL 1 input. 
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VCC (Device VCC) Selection Jumper Block 



PC: Probe card supplies a VCC of + 5V. 

TAR: Target system supplies VCC. 

EA (External Address) Selection Jumper Block 

In the 80C552 probe card, the EA jumper block is not functional; any position may be chosen. 

/RD (Read Signal) Control Jumper Block 



+ 5: Port 3.7 is an Input/Output pin. 

/RD: Port 3.7 is used as Read Signal pin. 

/WR (Write Signal) Control Jumper Block 



+ 5: Port 3.6 is an Input/Output pin. 

/WR: Port 3.6 is used as Write Signal pin. 

/EW (Enable Watchdog) Selection Jumper Block 



0: Emulator controls EW pin (EW = LOW = 0V) as Watchdog enabled. 

+ 5: Emulator controls EW pin (EW = HIGH = +5V) as Watchdog disabled. 

TAR: Target system controls EW pin. 



Device Orientation 



The 80C552 probe card is supplied with a probe head that has a PLCC footprint connection for the target 
system. Pin one orientation of the PLCC socket can be determined by viewing the probe head from the 
cable header (component) side. Pin one is on the side by the cable header on the board. 
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83C552, 83C652 and 83C654 Probe Cards 
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83C552, 83C652, 83C654 Probe Cards 



X1 and X2 (XTAL-Oscillator) Selection Jumper Block 



PC: Probe card's crystal is used. 

TAR: Target system supplies crystal or external clock. 

This is a double jumper to ensure correct configuration. The center post is the common post. 
XI connects to XTAL 1 input. 
X2 connects to XTAL 2 input. 
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83C552, 83C652 and 83C654 Probe Cards (16MHz) 



Revised 83C552, 83C652 and 83C654 Probe Cards. Replaces pages 4-34 and 4-35. 
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83C552, 83C652, 83C654 (16MHz) Probe Cards 



XTAL (Oscillator) Selection Jumper Block 

PC: Probe card's crystal is used. 

TAR: User's target system supplies crystal or external clock. 

This is a double jumper to ensure correct configuration. The center post is the common post. 

The LEFT side of the jumper block connects to XTAL 1 input. 

The RIGHT side of the jumper block connects to XTAL 2 input. 

4-34A 



VCC (Device VCC) Selection Jumper Block 



PC: Probe card supplies a VCC of +5V. 
TAR: User's target system supplies VCC. 

EA (External Address) Selection Juniper Block 



+5: Emulator controls EA pin (EA = HIGH = +5V) as ROM device. 
0: Emulator controls EA pin (EA = LOW = 0V) as ROMless device. 
TAR: User's target system controls EA pin. 

/RD (Read Signal Control) Jumper Block 



+5: Port 3.7 is an Input/Output pin. 
/RD: Port 3.7 is used as Read Signal pin. 

/WR (Write Signal Control) Jumper Block 



+5: Port 3.6 is an Input/Output pin. 
/WR: Port 3.6 is used as Read Signal pin. 

ROMP (ROM Code Protection) Jumper Block 



0: ROM Code protection disabled. 

No restrictions to the MOVC- instruction. 

1: ROM Code protection enabled. 

A MOVC-instruction executed from the external address space cannot access the 
internal ROM address range. There are no restrictions to the MOVC-instruction 
when executed from the internal address space. 

Device Orientation 



The 83C552, 83C652 and 83C654 probe cards are supplied with a probe head that has a 
PLCC footprint connection for the target system. Pin 1 orientation of the PLCC socket 
can be determined by viewing the probe head from the cable header side. Pin 1 is on 
the middle of the left side as designated. 
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83C552, 83C652 and 83C654 Probe Cards (12MHz) 
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83C5S2, 83C652, 83C654 (12MHz) Probe Cards 



XI & X2 (Oscillator) Selection Jumper Block 

PC: Probe card's crystal is used. 

TAR: User's target system supplies crystal or external clock. 

This is a double jumper to ensure correct configuration. The center post is the common post. 
The LEFT side of the jumper block connects to XTAL 2 input. 
The RIGHT side of the jumper block connects to XTAL 1 input. 

4-34C 



EA (External Address) Selection Jumper Block 



+5: Emulator controls EA pin (EA = HIGH = +5V) as ROM device. 
GND: Emulator controls EA pin (EA = LOW = OV) as ROMless device. 

RD (Read Signal Control) Jumper Block 

+5: Port 3.7 is an Input/Output pin. 
RD: Port 3.7 is used as Read Signal pin. 

WR (Write Signal Control) Jumper Block 

+5: Port 3.6 is an Input/Output pin. 
WR: Port 3.6 is used as Read Signal pin. 

/EW (Enable Watchdog Timers) Selection Jumper Block 



GND: Emulator controls EW pin (EW = LOW - OV) as Watchdog enable. 
TAR: Target system controls EW pin. 

+5: Emulator controls EW pin (EW = HIGH * +5V) as Watchdog disabled. 



The 83C552, 83C652 and 83C654 probe cards are supplied with a probe head that has a 
PLCC footprint connection for the target system. Pin 1 orientation of the PLCC socket 
can be determined by viewing the probe head from the cable header side. Pin 1 is on 
the top of the 87C552 socket device side as designated. 
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EA (External Address) Selection Jumper Block 



GND: Emulator controls EA pin (EA = LOW = OV) as ROMless device. 
+ 5: Emulator Controls EA pin (EA = HIGH = + 5V) as ROM device. 

/RD (Read Signal) Control Jumper Block 



+ 5: Port 3.7 is an Input/Output pin 

TAR: Port 3.7 is used as Read Signal pin. 

/WR (Write Signal) Control Jumper Block 



+ 5: Port 3.6 is an Input/Output pin. 

TAR: Port 3.6 is used as Write Signal pin. 

/EW (Enable Watchdog) Selection Jumper Block 



GND: Emulator controls EW pin (EW = LOW = OV) as Watchdog enabled. 
+ 5: Emulator controls EW pin (EW = HIGH = + 5V) as Watchdog disabled. 

TAR: Target system controls EW pin. 

Device Orientation 



The 83C552, 83C652 and 83C654 probe cards are supplied with a probe head that has a PLCC footprint 
connection for the target system. Pin 1 orientation of the PLCC socket can be determined by viewing the 
probe head from the cable header connector side. Pin one is on the middle of the top side. 
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83C552 Modes Of Operation 

Mode 1; ROMless (80C552), Watchdog Timer Off, /EA = Low 

In this mode of operation, the emulator is configured to operate as a ROMless version of the 
microcontroller. The EA jumper must be set LOW. All code memory fetches are external. There are no 
mapping constraints in this mode. 

In addition, the assumption is made that your application code will not enable the Watchdog Timer. If 
your application does enable the Watchdog Timer while in this mode it is possible that a Watchdog Timer 
Reset may occur while the emulator is in break condition. If the Watchdog Timer Reset occurs the state 
of the device at that time will be lost. 

Mode 2; ROM (83C552), W atchdog Timer O ff, /E A m H igh 

This is the default mode. In this mode of operation, the emulator is configured as a ROM version of the 
microcontroller. The EA jumper must be set HIGH. Code memory fetches within the ROM address 
space (0 through 8K) are internal. Code memory fetches outside the ROM address space are external. 
The ROM area in code memory must be mapped to the emulator. 

In addition, the assumption is made that your application code will not enable the Watchdog Timer. If 
your application does enable the Watchdog Timer while in this mode it is possible that a Watchdog Timer 
Reset may occur while the emulator is in break condition. If the Watchdog Timer Reset occurs the state 
of the device at that time will be lost. 

Mode 3: ROMless f8nC552) r Watchdog Timer On r /EA = Low 

In this mode of operation, the emulator is configured to operate as a ROMless version of the 
microcontroller. The EA jumper must be set LOW. All code memory fetches are external. There are no 
mapping constraints in this mode. 

In addition, the assumption is made that your application code has enabled the Watchdog Timer. While 
in break condition in this mode, the emulator executes the code necessary to refresh the Watchdog Timer 
to prevent a Watchdog Timer Reset from occurring. Of course, while in emulation condition your 
application code is responsible for refreshing the Watchdog Timer. 

Mode 4; R OM ( 83C552 ) , Wa tchdog Timer O n, /E A = H igh 

In this mode of operation, the emulator is configured as a ROM version of the microcontroller. The EA 
jumper must be set HIGH. Code memory fetches within the ROM address space (0 through 8K) are 
internal. Code memory fetches outside the ROM address space are external. The ROM area in code 
memory must be mapped to the emulator. 

In addition, the assumption is made that your application code has enabled the Watchdog Timer. While 
in break condition in this mode, the emulator executes the code necessary to refresh the Watchdog Timer 
to prevent a Watchdog Timer Reset from occurring. Of course, while in emulation condition your 
application code is responsible for refreshing the Watchdog Timer. 
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83C751 Probe Card 



XTAL 



PC 



TAR 



83C751 
DEVICE 




VCC 



Pin 1 



B T 



83C751 Probe Card 



XTAL (Oscillator) Selection Jumper Block 



CLIPS 



50-Pin 

Cable 

Header 



PC: Probe card's crystal is used. 

TAR: Target system supplies crystal or external clock. 

This is a double jumper to ensure correct configuration. The center post is the common post. 
The LEFT side of the jumper block connects to XTAL 2 input. 
The RIGHT side of the jumper block connects to XTAL 1 input. 
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VCC (Device VCC) Selection Jumper Block 



PC: Probe card supplies a VCC of + 5V. 

TAR: Target system supplies VCC. 

Device Orientation 



The 83C751 probe card is supplied with a probe head that has a DIP footprint connection for the target 
system. Pin one side orientation of the DIP can be determined by viewing the probe head from the cable 
header (component) side. Pin one is in the lower right corner, just above the VCC printed on the board. 
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83C752 Probe Card 



50-Pin 

Cable 

Header 



XTAL 



PC 



TAR 



Pin 1 



83C752 
DEVICE 



CL 



83C752 Probe Card 



XTAL (Oscillator) Selection Jumper Block 



PC: Probe card's crystal is used. 

TAR: Target system supplies crystal or external clock. 

This is a double jumper to ensure correct configuration. The center post is the common post. 
The LEFT side of the jumper block connects to XTAL 2 input. 
The RIGHT side of the jumper block connects to XTAL 1 input. 
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Device Orientation 



The 83C752 probe card is supplied with a probe head that has a DIP footprint connection for the target 
system. Pin one side orientation of the DIP can be determined by viewing the probe head from the cable 
header (component) side. Pin one is in the upper left corner of the device. 
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Map of Clock Jumpers for 803X Type Probe Cards 



Map of Clock Jumpers for iceMASTER 
803 1 /8032/8344/80C5 1 FA/80C1 54/80C321 /80C4 1 0/80C652/80C85 1 


Probe 
Card 


Device 
Type On 
Probe 
Card 


Target 
Device 
Type * 


Clock Source 


Jumpers 


Crystal 


External 
Clock 
Driver 


Probe 
Card 


Target 
System 


XTAL 


C/N- 
NORM 


XTAL1- 
XTAL2 


I 8344 


NMOS 


NMOS 


X 






PC 


NORM 


XTAL2 


8344 


NMOS 


NMOS 




X 




TAR 


NORM 


XTAL2 


8344 


NMOS 


NMOS 






X TAR 


NORM 


XTAL2 


** 


CMOS 


CMOS 


X 






PC 


NORM 


XTAL2 


** 


CMOS 


CMOS 




X 




TAR 


NORM 


XTAL2 


** 


CMOS 


CMOS 






X 


TAR 


NORM 


XTAL2 


** 


CMOS 


NMOS 


X 






PC 


NORM 


XTAL2 


** 


CMOS 


NMOS 




X 




TAR 


NORM 


XTAL2 


** 


CMOS 


NMOS 






X 


TAR 


C/N+ 


XTAL2 



* Under the "Target Device Type" column, CMOS means any CMOS microcontroller supported by the 
iceMASTER emulator base. NMOS means any NMOS microcontroller supported by the iceMASTER 
emulator base. 

** These marked positions apply to all iceMASTER Probe Cards except the 8344. 
+ C/N means "CMOS part emulating an NMOS part". 
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Map of Clock Jumpers for the 8052 Probe Card 



Hap of Clock Jumpers for iceMASTER 


Probe 
Card 


Target 
Device 
Type 


Clock Source 


Jumpers 


Crystal 


External 
Clock 
Driver 


Probe 
Card 


Target 
System 


XTAL 


CMOS 
NMOS 


8052 


CMOS 


X 






PC 


CMOS 


8052 


CMOS 




X 




TAR 


CMOS 


8052 


CMOS 






X 


TAR 


CMOS 


8052 


NMOS 


X 






PC 


CMOS 


8052 


NMOS 




X 




TAR 


CMOS 


8052 


NMOS 






X 


TAR 


NMOS 
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Chapter 5: Software Installation 



Emulator System Requirements 

Be sure you Have everything you need. A basic emulator system includes a power supply, the iceMASTER 
emulator base, one or more probe cards (depending on how many you ordered), one 50 pin flat cable, one 
RS-232 serial cable with a 25 pin connector, one probe clip assembly, one manual and two software 
diskettes. 

A power source is required to operate the emulator. You may use your own power supply (5 volts at 1.5 
amperes is required) or you may purchase a MetaLink optional power supply- 
Please stop now and take a moment to be sure you have all the items you need. If you are missing 
something, call us! 

Most Computer Requirements 

At a minimum, the Host Computer requirements are: 

1) IBM PC/XT/ AT or 1 00% compatible, 

2) 640K bytes or RAM. 

3) one floppy disk drive. 

4) one hard disk dive, 
_*> ) one serial port, and 
6) DOS 2.0 Cor later). 

You may perform the software installation before or after the hardware installation. Both must be 
completed, however, before you can use either. 
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Installation 



The emulator Host Software system is shipped on two 5-1/4 inch, double-sided, double-density floppy 
diskettes (unless otherwise requested). One diskette is labeled Host Software and the other is labeled 
Probe Card Software. Be sure to make backup copies of these diskettes, never remove the write-protect 
tabs from either diskette and store the diskettes in a safe place. The files on both diskettes are in a packed 
format and are self-unpacking. 

The installation procedure will unpack the files from the distribution diskettes, creating the Host Software 
system, utility and example program files on your hard disk. This will require approximately 2.1 megabytes 
of hard disk space before beginning installation. After installation the Host Software system will occupy 
approximately 1.7 megabytes of hard disk space. 

To start the software installation process, place the diskette labeled Host Software in drive A: and type 

A:INSTALL 

The install program will lead you through the installation procedure. The purpose of each unpacked file 
is explained in the README_1.DOC and README_2.DOC files. These files are displayed as part of 
the installation procedure. In addition, the utility program MF_GEN.EXE is invoked automatically to 
generate a $MODEL file to allow use of the emulator probe card that was purchased. This SMODEL file 
is read by the Host Software during its initialization sequence. Note that MF_GEN.EXE may be 
reinvoked manually to generate a $MODEL file for another probe card. If you do this be sure to rename 
it, or use the name definition ability in MF_GEN.EXE to name the new file something other than the 
default, which is $MODEL, to avoid overwriting the existing $MODEL file. 
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This chapter is an overview of some of the features of the Host Software and a guide to help you 
understand the layout of the screen and the terminology used to describe the Host Software. For complete 
information on any command please refer to the Command Reference (Chapter 7). 

Terminology 



When discussing the user interface we will refer to the main program as the Host Software and the 
computer you are using as the Host Computer. 

All references to commands will be in italics (e.g., Step). All references to command sequences will be in 
italics with commands separated by a vertical bar (e.g., Configure \Emulator\ Execute). 

References to file names, directory structures and disk drive designations will always be shown in upper 
case (e.g., C:\IM51\DEMO.DBG). 

Where shown, user responses will be in boldface and special keys will be shown in boldface as they are 
depicted on a standard IBM PC keyboard (where possible), as follows: 



Alt Key Alt 

Arrow or Cursor Keys «--» t i 

Control Key Ctrl 
Delete Character To Left Key Bksp 

Delete Key Del 

End Key End 
Enter or Carriage Return Key Enter 

Escape Key Esc 

Function Keys Fl ... F10 

Home Key Home 

Insert Key Ins 

Page Down Key PgDn 

Page Up Key PgUp 

Print Screen Key PrtSc 

Space Bar Space 

Tab Key Tab 
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Main Menu Bar - 



Main Men 
Windows 




Function Key 
Label Lines 



Configure File Run iil».lMI!JiinSfl Hisc Source'Syakoli Break^Trace Help 

:8 p:e 

48 iocom aa ip ca 

F PCOM 78 PSU 88 RCAP2H 88 
<» ioM^ Change Coda Heaoru i 
Hove Compare Urite | 
fill— 



I — Bank 
R8:B8 R1:BB 112:88 R3 : 

nCC 88 B 

PB FF PI FT 

RCAP2L -88 SBUF 88 
TLB 98 TH1 




4-8880 BB 88 08 88 88 

— Hodule:F_HLnAlM 

F_HLM«IN:«33 at 



Uar/Reo Alt 



FAM-Bita ftlt 



88A1 F521 
F_HUMIN:t3S 



F_HLM«1M:«36 
08A5 CZSfl 
F_HLhV>IH:I37 



WW SIfl 
for ( counter 

nog con 
pi_b = a; 

CLR PI 
Innerloopf 



lo 

Pattern 



-EacJCancel- 



8818 8888888888888888 
8818 88 88 88 88 88 88 88 88 
8828 88 88 88 88 88 88 88 88 



88 88 08 00 00 00 00 
88 88 08 88 BB 08 08 



BrkCnt:8 



3OTpa State: Break-point DPTR:B888 PC 
Partial Read: 98* Trl 9 :End 



Pull-down Menu 



Dialog Box 




Fill a block of Coda aa-oru 



Menu Bar 
Window 



Quick Help Line 



Quick Help 
Line 



Function Key 
Label Lines 



Window 



Main Screen 
Windows 



Menu Bar 
Window 



Pull-down 
Menu 



The Quick Help Line refers to the line on the display just above the Function Key Label Lines. If none 
are displayed then the Quick Help Line will be the bottom line of the display. The Quick Help Line is 
used to explain (briefly) what the currently highlighted command is used for. This line is always displayed. 

Function Key Label Lines are optionally displayed at the bottom of the display, below the Quick Help 
Line. They are used as a quick reference to the 40 Function Key Assignments (Hot Keys). By default 2 
lines are displayed but up to 4 lines can be displayed (see Configure \Function Key [Lines on page 7-23). 

Note that the term Window is a descriptive term that refers to various parts of the display presented by 
the Host Software such as the RAM-bits Window (see Display IAlter\RAM-Bits on page 7-40). It is not 
intended to imply compatibility with the Microsoft Windows operating environment or any other similar 
system. 

The Main Screen Windows are a special subset of all windows. They are intended to be the platform from 
which an emulation session is controlled. Access to all the major groups of commands is available from 
the Main Menu Bar. The Main Screen Windows are completely configurable for content and position (see 
Configure \ Windows \ Modify on page 7-17) and for size (see Configure \ Windows \ Size on page 7-18). See 
the Configure \ Windows command on page 7-13 for a complete description of the window types available 
on the Main Screen. Note that the data in all of the Main Screen Windows is updated every time there is 
a break from emulation, including after a single step (see Run \ Step on page 7-34 and between each 
instruction during slow motion mode (see Run \Slow Motion on page 7-34) and whenever the Config- 
ure | Windows | Repaint command (page 7-19) is selected. 

A Menu Bar Window is a window that contains a selection of commands arranged horizontally. The 
highlighted command is the current command. When a command is selected (see Selecting Commands 
on page 6-4 in this chapter) it may call another Menu Bar Window, it may call a Pull-down Menu, or it 
may perform a function. 

A Pull-down Menu contains a selection of commands (generally related) arranged vertically in a box 
positioned (if possible) just below the command that was selected. The highlighted command is the 
current command. Just as in a Menu Bar, when a command is selected it may call a Menu Bar Window or 
a Pull-down Menu, or perform a function. 
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Dialog Box A Dialog Box refers to a box that is presented on the display to prompt you for some information such as 
a filename (see File \Load on page 7-27) or an address (see Run \ Until on page 7-34). Most Dialog Boxes 
retain the information you typed from the last time the same command was selected. Editing of retained 
and newly typed information is possible using the following keys: 

*■ Move cursor one position to left 

-» Move cursor one position to right 

Ctrl-Home Move cursor to left most position of line 

Ctrl-End Move cursor to right most position of line 

Ins Toggle insert/overwrite mode 

Del Delete character under cursor 

Bksp Delete character to the left of cursor and move 

cursor one position to left 

Enter Accept typed (or edited) information 

Esc Cancel input 



Diagnostic 
Message Box 



Status Box 



Confirmation 
Box 



Note that the Dialog Box used to prompt for filenames is a special form of Dialog Box that includes all 
the standard features mentioned above, plus the ability to view directory listings. See the description of 
the Filenames and Directory Facility features in this chapter. 

A Diagnostic Message Box refers to a box that is presented to display error and warning messages and 
other information important enough for you to see. Generally, the Diagnostic Message Box will be 
presented in the center of the display and the computer will beep, unless this feature is disabled (see 
Configure \ Options \ Diagnostic on page 7-21) . The Diagnostic Message Box will remain on the display until 
you press Esc. 

Status Boxes are generally used to inform you of the progress of a task that the Host Software is 
performing and require no response from you. For example, when loading a file several Status Boxes will 
be displayed to inform you of the progress of the file load. Note that at times the Status Boxes may be 
removed from the screen before you can read them. This merely indicates that the task being performed 
took only a short time to complete. 

A Confirmation Box refers to a box that is presented to confirm your intention to execute the command 
you selected. All Confirmation Boxes accept only a Yes (Y), No (N) and Cancel (C or Esc) response. Note 
that in most cases the No and Cancel response are equal, but there are several cases where they are not 
(e.g., Display /Alter \ Code \ Write \ Dump on page 7-39) . In any case, the Confirmation Box will tell you what 
each option means where it is not obvious. 
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Selecting Commands 



Host Software commands may be selected using the keyboard or a mouse (see Appendix I for information 
on using a mouse). Selecting a command is the generic phrase used to describe the process of executing 
a command by moving the highlight bar (via cursor keys or mouse) to the desired command and pressing 
Enter or using a Quick Key or a Hot Key. 

Quick Key refers to the highlighted alphanumeric character in a command name which can be used to 
select a command. The Quick Key is most often the first character in the command name. For example, 
when working at the Main Menu Bar, pressing the letter C means select the Configure command. 

Hot Key refers to one of the 40 Function Keys that can be used to select a command, as follows: 

Fl 

Shift-Fl 
Ctrl-Fl 
Alt-Fl 

The Function Keys are assigned at the factory to commonly used commands (see Appendix N for a list of 
default assignments) but can be reassigned using the Configure [Function Key\Modify command (page 
7-23). Note that a Hot Key can be used from just about anywhere in the Host Software (except during an 
emulation or a performance analysis) to immediately select a command without having to traverse the 
menu structure to find the command. 

Features 



... F10 

... Shifl-FlO 

... Ctrl-F10 

... Alt-FlO 



Help 



Command 
Line Options 



Detailed and context sensitive Help is available on-line using the Hot Key assigned to Help (by default 
Fl, but this can be changed using the Configure \Function Key \Modify command on page 7-23). Pressing 
the Help Hot Key pops up a Help Window to display information about the currently highlighted 
command. Once you are in the Help System, information may also Hyperlinked to other, related Help 
topics. 

There are several command line options that provide useful shortcuts for entering the Host Software and 
performing tasks that would require executing several commands. The following are examples of some of 
these shortcuts: 



ICE DEMO .DBG 



ICE -S C:\ 



Load DEMO.DBG (see File\Load on page 7-27) and establish 
communication with the emulator (see Configure \Emulator on page 

7-2). 

Set the HLL search path to c:\ (see Source I Symbols {Source Path on 
page 7-52). 

Start the macro file DEMO.MAC (see File \Macro on page 7-30). 



ICE -I DEMO.MAC 

There are many command line options, each of which is described in detail in Appendix J. 

Macros Macros allow you to create scripts of keystrokes (that may be commands or responses to prompts) that 

can be called when needed. Typically, these would be for repetitive tasks and tasks such as setup for a 
debug session, but can be used for any purpose. For a full description of Macros refer to File [Macro on 
page 7-30. 
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Warm Start If an emulator is powered up and configured, you may leave the Host Software to return to DOS and then 
return to the emulator Host Software at a later time without having to reconfigure the emulator. All 
symbolic information and map settings will be lost but the emulator's memory segments (code, external 
data, internal data, and SFR's) will retain their values. Of course, this requires that power to the emulator 
be maintained between the debugging sessions. 



Dynamically When emulating using single steps (Run \ Step on page 7-34) or slow motion mode (Run \ Slow Motion) on 
Annotated page 7-34), the right side of the Main Source Window is used to display a history of execution for each 
Code instruction executed. This history contains the value (before execution of the instruction) of any Direct 

Address, Indirect Address, SFR and Bit used by the instruction. In addition, if the instruction is an 
unconditional jump instruction or a conditional jump, where the condition is met (TRUE), the Target 
Address and an arrow indicating direction of program flow will be displayed. If the instruction is a 
conditional jump, where the condition is not met (FALSE), a * is displayed. 

Moving A Many windows can be moved to any position on the display using the Ctrl-V command. Once you press 
Window the Ctrl-V key combination, a new border will be painted around the current window and the window can 

then be moved. The computer will beep when the window cannot be moved in the direction specified (e.g., 

a window cannot cover the Quick Help Line). 



At this point the following keys are active: 



** -* f I move whole window in indicated direction 

Esc abort move, leave the window in the position it was 

in when Ctrl-B was pressed 

Enter exit move, accept new window position 



The Main Screen Windows are moved in another way. Their ordering and position may be changed using 
the Configure \ Windows \Modify command (page 7-17). Note that for the Main Screen Windows using the 
Ctrl-V command is equivalent to selecting the Configure | Windows \Modify command. 

Resizing A Many windows can be resized on the display using the Ctrl-R command. Once you press the Ctrl-R key 
Window combination, a new border will be painted around the current window and the window can then be 

resized. The computer will beep when the window cannot be resized in the direction specified. 

At this point the following keys are active: 

t I move bottom border in indicated direction 

*■ -* move right border in indicated direction 

Esc abort resize, leave the window the size it was in 

when Ctrl-R was pressed 

Enter exit resize, accept new window size 

The Main Screen Windows are resized in a similar fashion. Their size may be changed using the 
Configure \ Windows \ Size command (page 7-18). Note that for the Main Screen Windows using the Ctrl-R 
command is equivalent to selecting the Configure \ Windows \Size command. 
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Change Mode When in Change Mode you may use the cursor keys to select a data item in the current window and modify 
its value. Change Mode is available from the Display/Alter\Code Window (page 7-38), the Dis- 
play/Alter \Idata Window (page 7-38), the Display I Alter \Xdata Window (page 7-38) and for all Main 
Screen Windows except the Main Source Window. In the Main Register Window, Change Mode is 
indicated by a highlighted data item and in other windows a box containing the address of the data item 
will be displayed underneath the highlighted data item. 

To enter Change Mode from the Dispiay/Alter\Code Window, the Display /Alter \Idata Window and the 
Display/Alter \Xdata Window you must first be in Browse Mode (see Display /Alter \ Code \Browse on page 
7-38). When in Browse Mode press Tab or Shift-Tab (they are equivalent) to enter Change Mode. 

To enter Change Mode from the Main Screen Windows press Tab or Shift-Tab (which is simply a 
convenient shortcut for the Configure | Windows | Goto command on page 7-18). The first time either key 
is pressed Change Mode becomes active in the window at the top of the display. Subsequent Tabs make 
Change Mode active in the next window down, each time advancing one window and wrapping from the 
bottom window back to the top window. Subsequent Shift-Tabs make Change Mode active in the next 
window up, each time moving up one window and wrapping from the top window back to the bottom 
window. Note that windows (i.e., Main Source) where Change Mode is unavailable are skipped during 
this process. 

Once in Change Mode the following keys are active: 

- t* t I 
PgUp 
PgDn 
Home 
End 
Esc 
Enter 
Tab 

Shift-Tab 



Note also that pressing any alphanumeric character while in Change Mode will open a Dialog Box to enter 
new data. 



move currently selected data item 

move up one window full of data 

move down one window full of data 

move to beginning of data 

move to end of data 

exit Change Mode 

open a Dialog Box to enter new data 

Main Windows: next window 
Display/ Alter: exit Change Mode 

Main Windows: previous window 
Display/ Alter: exit Change Mode 
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Filenames 



Whenever the Host Software needs a filename, a special Dialog Box is used to prompt for the name. When 
prompted for a filename, you may request a directory listing (explained below), or may enter a file 
specification. A file specification is any legal DOS file specification which may include a drive designation 
and directories in addition to the filename. Some legal DOS file specifications follow: 

DEMO .DBG DEMO.DBG in default directory on default drive 

C:DEMO.DBG DEMO.DBG in default directory on drive C: 

C:\IM51DEMO\DEMO.DBG DEMO.DBG in \IM51DEMO directory on drive C: 

After entering a file specification the Host Software will attempt to open the file. 

Reading A File If the file cannot be found or cannot be opened you will be notified by an error message, as follows: 

File 'filename' not found. ("DOS message") 

where "DOS message" explains the DOS file open error code (explained in the DOS reference manual). 
If the file is found and can be opened, informational messages will be displayed to inform you of the 
progress of the read operation. These messages will vary depending on what type of file is being read. 

Writing A File If the file cannot be found the Host Software will automatically create the file. If the file cannot be opened 
you will be notified by an error message, as follows: 

Cannot open 'filename'. ("DOS message") 

where "DOS message" explains the DOS file open error code (explained in the DOS reference manual). 

If the file already exists and the information to be written is intended as human readable text (such as a 
write of the decoded trace buffer) you may want to append this information to the existing file. In this case 
you will be prompted through a Confirmation Box as follows: 

File already exists. Do you wish to append? (Yes = append, No = overwrite) 

where pressing Y means append (Yes) to the end of the existing file, pressing N means overwrite (No) the 
existing file and pressing Esc or C cancels the write operation. 

If the file already exists and the information to be written is intended as reloadable data (such as a write 
of code memory in hex format) you may not want to overwrite the existing file. In this case you will be 
prompted through a Confirmation Box as follows: 

File already exists. Do you wish to overwrite? 

where pressing Y means overwrite (Yes) the existing file and pressing N, Esc or C cancels the write 
operation. 
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Directory Facility 



At any filename prompt you may obtain a directory listing by pressing either ? or !. Pressing ? invokes a 
terse (filename only) directory listing (the same information produced by the DOS command DIR /W/P). 
Selecting ! invokes a verbose (filename, size, and date) directory listing (the same information produced 
by the DOS command DIR/P). 

After choosing either type of directory listing a Dialog Box will prompt you for the directory to list. You 
may enter any legal DOS path specification which may include a drive and/or directories. Just pressing 
Enter selects a directory listing of the default directory on the default drive. Some legal DOS path 
specifications follow: 



C: 

\IM51 

A:\IM51\EXAMPLES 



default directory on drive C: 
\IM51 directory on default drive 
\IM51\EXAMPLES directory on drive A: 



The directory listing will be displayed a page at a time. Each page will be displayed until the user responds 
to the prompt: 

Press any key to continue. 

In order to use the directory facility the Host Software must have access to the COMMAND.COM file. 
See DOS Information (Appendix L) for detailed information on the COMMAND.COM file. 
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Chapter 7: Command Reference 



The Main Menu Bar lists seven major groups of commands (phis Help). Related commands and functions 
of the Host Software are gathered together under these headings. This chapter will discuss each command 
in-depth in the left-to-right and top-to-bottom sequence in which you will encounter them in the Host 
Software. 

As we proceed, each subpath encountered will be taken until there are no further possible branches. 
Discussion will then continue with the next command in sequence. Note that since different devices have 
different features, some commands will be unavailable for use. These commands will be de-activated in 
the Host Software and will use the de-emphasized display attributes assigned in the current video settings. 

The major command groups are: 

Configure 

File 

Run 

Display/Alter 
Misc 

Source/Symbols 
Break/Trace 



7-1 



lonf igure| 



File R 



The Configure command calls a Pull-down Menu from which you have 
access to commands that enable you to configure your emulation environ- 
ment, including both Hardware (communication parameters, operating 
mode and mapping) and Software (video parameters, window configuration 
and Function Key assignment). The commands are: 



Configure \ Emulator 



nu 1 atop 



-Mapping — 
Code Memory 
Xdata Memory 
Display — 



Attr ibutes 
U indous 



I dent if ication 
Options ► 
Function-Keys ► 
Save ► 
Restore 



File Run 



The Emulator command calls a Pull-down Menu from which you may set 
the operating mode of the microcontroller and communication param- 
eters, and establish communication with the emulator. The current 
settings for each are displayed in the Pull-down Menu next to the 
command associated with that function. The commands are: 




Configure | Emulator \ Execute 

The Execute command causes the Host Software to establish communication with the emulator base and 
sets the operating mode of the microcontroller. 

The communication parameters (communication port and baud rate) and operating mode used are read 
from the SCONFIG file, if it exists. If the $CONFIG file does not exist, default values are used. In either 
case, the current setting for each of the values is shown in the Pull-down Menu. The defaults are: 

Mode device dependent (see Probe Card Reference) 

Comm port COM1 
Baud rate 115200 

Configure | Emulator \ Mode 

If the Mode command is active that means there is more than one possible mode of operation for the 
current device. Selecting the Mode command calls a Pull-down Menu from which you may select the 
desired mode of operation for your environment. If the Mode command is de-activated that means there 
is only one possible mode of operation for your device (e.g., the 8032 is a ROMless only device). The 
default mode of operation is device dependent, therefore see the Probe Card Reference for Mode 
information on your device. 

Note that if the mode of operation is changed the SCONFIG file is updated (or created) automatically 
but the actual mode of operation of the device will not be set until the Execute command is selected. 



Configure \ Emulator \ Comm port 



The Comm port command calls a Pull-down Menu from which you may select the active communication 
port used for serial communication between the Host Computer and the emulator base. The default 
communication port used is COM1. 

Note that if the communication port is changed the $CONFIG file is updated (or created) automatically 
but the actual communication port used during serial communication will not be updated until the Execute 
command is selected. 

Configure \ Emulator \ Baud rate 

The Baud rate command calls a Pull-down Menu from which you may select the baud rate used during 
serial communication between the Host Computer and the emulator base. There are six possible values 
for Baud Rate: 

115200 

57600 

38400 

28800 

19200 

9600 

Setting the baud rate is handled by the Host Software and is independent of any baud rate set by you from 
DOS. The default baud rate used is 115200. 

Note that if the baud rate is changed the $CONFIG file is updated (or created) automatically but the 
actual baud rate used during serial communication will not be updated until the Execute command is 
selected. 
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Configure | Code Memory 
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The Code Memory command calls a Menu 
Bar Window from which you may map 
Code Memory to either the emulator's 
Code Memory or your target board's 
Code Memory in 16-byte blocks. Changes 
in map settings are downloaded to the 
emulator as they are made. 

Note that there are some mapping con- 
straints due to emulator and device de- 
pendencies (e.g., in ROM mode all ROM 
space must be mapped to the emulator). 
The mapping constraints are enforced. 

Mapping constraints (if any) are discussed in the description of each probe card in the Probe Card 
Reference (Chapter 4). The current mode of operation of your device is displayed in the window. The 
commands arer 



- FFFF 



Configure \ Code Memory \ Emulator 

The Emulator command allows you to map blocks of Code Memory to the emulator. You will be prompted 
for the starting and ending address of the block by a Dialog Box. Note that the 16-byte blocking of mapping 
will be enforced here (if necessary) by adjusting the starting address you entered to the next lowest 16-byte 
boundary and the ending address to the next highest 16-byte boundary minus 1. 

You will be notified of mapping constraint violations by error message. 



Configure \ Code Memory {Target 



The Target command allows you to map blocks of Code Memory to the target board. You will be prompted 
for the starting and ending address of the block by a Dialog Box. Note that the 16-byte blocking of mapping 
will be enforced here (if necessary) by adjusting the starting address you entered to the next lowest 16-byte 
boundary and the ending address to the next highest 16-byte boundary minus 1. 

You will be notified of mapping constraint violations by error message. 

Configure \ Code Memory \ All 

The All command calls a Pull-down Menu from which you may map all of Code Memory to either the 
emulator or the target board. When either is selected the Host Software will attempt to map all Code 
Memory to the indicated area and will enforce mapping constraint violations without any error messages 
being issued. 



Configure \ Code Memory | Load 



The Load command allows you to load map settings from a previously saved file (via the Configure \ Code 
Memory \ Save or Configure \Xdata Memory \ Save commands). You will be prompted for the filename by a 
Filename Dialog Box. 
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Note that both Code Memory and External Data Memory map settings are loaded from the file. 

Configure \ Code Memory \ Save 

The Save command allows you to save the current map settings to a file so that they may be loaded (via 
the Configure | Code Memory | Load or Configure \Xdata Memory \Load commands) at a later time. You 
will be prompted for the filename by a Filename Dialog Box. 

Note that both Code Memory and External Data Memory map settings are saved to the file. 
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Configure \Xdata Memory 



Note that the Xdata Memory command 
will be de-activated if the device in use has 
no ability to access External Data Mem- 
ory. 



The Xdata Memory command calls a 
Menu Bar Window from which you may 
map External Data Memory to either the 
emulator's External Data Memory or your 
target board's External Data Memory in 
16-byte blocks. Changes in map settings 
are downloaded to the emulator as they 
are made. 



Note that there are some mapping constraints due to emulator and device dependencies (e.g., on 
emulators with only 16K of External Data Memory only 16K can be mapped to the emulator). The 
mapping constraints are enforced. Mapping constraints (if any) are discussed in the description of each 
probe card in the Probe Card Reference (Chapter 4). The current mode of operation of your device is 
displayed in the window. 

The commands are: 

Configure \Xdata Memory] Emulator 

The Emulator command allows you to map blocks of External Data Memory to the emulator. You will be 
prompted for the starting and ending address of the block by a Dialog Box. Note that the 16-byte blocking 
of mapping will be enforced here (if necessary) by adjusting the starting address you entered to the next 
lowest 16-byte boundary and the ending address to the next highest 16-byte boundary minus 1. 

You will be notified of mapping constraint violations by error message. 

Configure \Xdata Memory \Target 

The Target command allows you to map blocks of External Data Memory to the target board. You will be 
prompted for the starting and ending address of the block by a Dialog Box. Note that the 16-byte blocking 
of mapping will be enforced here (if necessary) by adjusting the starting address you entered to the next 
lowest 16-byte boundary and the ending address to the next highest 16-byte boundary minus 1. 

You will be notified of mapping constraint violations by error message. 

Configure \Xdata Memory \ All 

The All command calls a Pull-down Menu from which you may map all of External Data Memory to either 
the emulator or the target board. When either is selected the Host Software will attempt to map all 
External Data Memory to the indicated area and will enforce mapping constraint violations without any 
error messages being issued. 
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Configure \Xdata Memory \ Load 



The Load command allows you to load map settings from a previously saved file (via the Configure \Xdata 
Memory \ Save or Configure \ Code Memory \ Save commands). You will be prompted for the filename by a 
Filename Dialog Box. 

Note that both Code Memory and External Data Memory map settings are loaded from the file. 

Configure \ Code Memory \ Save 

The Save command allows you to save the current map settings to a file so that they may be loaded (via 
the Configure \Xdata Memory \Load or Configure \ Code Memory \ Save commands) at a later time. You will 
be prompted for the filename by a Filename Dialog Box. 

Note that both Code Memory and External Data Memory map settings are saved to the file. 



Configure \ Attributes 



The Attributes command calls a Pull-down Menu from which you 
may set the number of display lines and display attributes and 
colors. The commands are: 



Configure \ Attributes \ Lines 

The Lines command is used to set the number of display lines. 
The current number of display lines is displayed next to the Lines 
command. When the Lines command is selected a Pull-down 
Menu will list your choices. The choices available are dependent on the video display adapter installed in 
your Host Computer (the others will be de-activated): 

MDA (Monochrome Display Adapter) 25 lines 

CGA (Color Graphics Adapter) 25 lines 

EGA (Enhanced Graphics Adapter) 25 lines 

43 lines 

VGA (Video Graphics Array) 25 lines 

28 lines 
50 lines 

Note that use of the '-V command line option (Appendix J) will de-activate the Lines command. 

Configure | Attributes \ CGA/ EGA/VGA Default 

The CGA/EGAIVGA Default command sets up video colors and other display attributes suitable for all 
color monitor types. The supplied binary file $CLR1$ contains these color definitions. These definitions 
make use of 16 foreground colors, but only 8 background colors. If you have an EGA or VGA installed in 
your system, the EGA/VGA Default provides a full 16 background colors. 

Configure \ Attributes | EGA/VGA Default 

The EGA/VGA Default command sets up video colors and other display attributes suitable for EGA and 
VGA color monitors. The supplied binary file $CLR2$ contains these color definitions. These definitions 
make full use of 16 foreground and 16 background colors. If you accidentally (or intentionally) select this 
command when the display adapter installed in your PC is actually a CGA or Monochrome adapter, many 
areas of the screen will blink! This is because the $CLR2$ file is set up assuming that the video display 
attribute control bit for "blink" actually means "bold (or bright) background". 

Configure \ Attributes \ Monochrome Default 

The Monochrome Default command sets up video display attributes suitable for monochrome adapt- 
ers/monitors. The supplied binary file $CLRM$ contains these color definitions. The only "color", other 
than black and white, available for monochrome adapters is blue. However, "blue" does not display as blue, 
but rather as underlining. If you accidentally (or intentionally) select this command when the display 
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adapter installed in your PC is actually something other than a Monochrome adapter, the video display 
indeed will be painted in a rather hideous combination of black, white and blue. 

Configure \ Attributes \ User 

The User command sets up video colors and other display attributes to your customized settings. The 
binary file $COLOR (not supplied) contains these color definitions. To create your own customized, 
default color definitions, first invoke the Select command to change the video colors and display attributes 
to your liking. 

The $COLOR file is read during iceMASTER initialization, thus establishing your own customized, 
default color definitions. 



Use the arrou keys to move the cursor to the attribute you uish to change: 



ody: Foreground (character ) color 



(Pr ess 1-8 , or ♦/'-/Space to toggle; 0=bl ink,9=bold) 
1-3E33H 2-blue 3-green 4-cyan 9-bold fg 

5-red 6-nagenta 7-yellou 8-white 8- 

Current: white on black 

(press Enter to select colors fron palette) — Borde 
Area/Feature CI HI L S E 



Sample Bo dy Text: 
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-Body- 
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down Menus : 
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■ Pull 
Pull 
Pull -down Menus 
Pull -down Menus 
Pull -down Menus 



Bars 

1st 

2nd 

3rd 

4th 



level 
level 
level 
level 



Quick-Help line at screen botton 
Function Key label lines 
Pop— up: Diagnostic Messages 
Pop— up: Ves/No/Cance 1 Questions 
Pop-up : Other Messages 
Dialog: File 
Dialog: Other 
Window: Registers 
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The Select command opens a window where you may select/modify video colors and other display 
attributes individually. These attributes and colors will remain active until you exit the Host Software. To 
make these changes permanent, select the Configure | Save | Save command (page 7-25) to save those 
settings into the SCOLOR file, making sure that the Save Option for Colors (Configure \ Save | Colors on 
page 7-25) is ON. 

Colors and attributes may be set in two ways. In both cases, you must position the cursor to the item you 
want to change and the results are displayed in an example box (in the top right of the window). 

The first method of changing colors and attributes is to select the foreground and background colors from 
the color chart (in the top left of the window) by number. Foreground changes take place when you 
position the cursor to the left of the item, and background changes are made when you position the cursor 
to the right of the item, as indicated by the arrow flags. 
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The second method allows you to choose color combi- 
nations from a palette. After the cursor is positioned to 
the item you wish to change, press Enter. This will pop 
up the palette available for your monitor type. You may 
then use the cursor keys to position to the color combi- 
nation you prefer. Press Esc to exit the palette without 
accepting your choice or Enter to accept your choice 
and exit the palette. 

The column headers on the right hand side of this dis- 
play are very short abbreviations for the following color 
controls: 




«— Ent 



Column Header 

CI border 

HI border 

L border 

S border 

E border 

CI body 

HI body 

Qk body 

Hk body 

VI body 

In body 

Is body 



Meaning 



box border color 

box border highlight color 

box border line style 

box border, shadow under box 

box border, exploding box 

box body color 

box body highlight color 

box body quick-key color 

box body hot-key color 

box body value color 

box body inactive (inaccessible) command color 

box body inactive (inaccessible) command selected 
(highlighted) color 



You will notice that the abbreviations and the explanations refer primarily to fields that appear in 
Pull-down Menus, although many apply to "boxes" in general. 

Some windows and menus overload the meaning of some otherwise "Not Applicable" color controls to 
govern a field or area which is unique to that menu or window. Those cases where the internal usage of a 
particular color control differs from the definitions given above are: 

Function Key Label Lines: 



CI body 
HI body 
In body 



Function Key numbers preceding labels 
Function Key labels 

Function Key label when associated command or 
menu is already active (invoked) 



Pop-up: Yes/No/Cancel 



HI body 
Qk body 



currently highlighted response 
Quick Key for "Yes", "No" or "Cancel" 



Window: Registers 



HI body highlighted "current register" 
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Ok bodv 


(TPRn values Heft side of 1st window line^ 


Hk body 


PSW bit values (right side of 1st window line) 


VI body 


register values 


Window: Source 




HI body 


current PC position 


Qk body 


operand value history information for instruction at 




current PC 


Hk body 


module name & line number comments 


VI body 


HLL source images 


Tn hodv 


nnprand value histnrv information for instructions 




other than that at current PC 


Window: Watch 




Qk body 


variable's name 


T Tl 1_ J 

Hk body 


variable s value when different from value at last 




break 


VI body 


variable's value 


Window: Status 




CI body 


names (labels) and all values which are not 




"heartbeat-updated" during emulation 


Qk body 


values for Real-Time Clock, Reset Count and State 


Hk body 


values for PC, Break Address and DPTR 


VI hndv 
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vaiuto Wiiiwn di t> iit/Oi lutal UpUuLtU UUi nig, 




emulation 


In body 


values for Trace Memory Status, Trace Memory 




Read and Trace Trigger 


Is body 


values for Break and Repetition Counters 


Menu: Help 




HI body 


boldfaced text 


Ok hoHv 




Hk body 


current ("tabbed-to") Hyperlink 


VI body 


underlined text 


Menu: Break-Point 


VI body 


current line highlight bar 


Menu: Oocode Class 


VI body 


current line highlight bar 


Menu: View Trace 


HI border 


digital waveform probe clip display: value lines 


Hk body 


digital waveform probe clip display: body 
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VI body HLL source images 



Menu: Disassembler/Assembler 



VI body HLL source images 



Menu: Code.Idata.Xdata View/Change 



Hkbody prompt/input line highlight VI body, current 

address highlight 



Menu: Performance Analyzer Setup 



VI body current line 1 



Menu: Performance Analyzer View 



Hk body bin information (percentage) lines - entire line 

except bar graph bars 

VI body HLL source images 

Menu: Performance Analyzer View (Highlights) 

CI body bar graph bars 

HI body real-time Clock, Sample Count and Reset Count 

values (post-emulation review) 

Qkbody PC and Break Address values (post-emulation 

review) 

Hk body values which are "heartbeat-updated" dynamically 

during emulation 

Menu: Configure Windows 

VI body current values/settings 

Qk body unusable window highlight 

Is body unusable window selected highlight 

Menu: Function Key View/Modify 

Hk body highlight for current line & title in current window 

(Assignment or Option) 

VI body highlight for current line in non-current window. 

Source/Symbol Displays 

Hk body accessible (can be referenced) source line numbers 

- those source line numbers for which the compiler 
generated debugging information (used only in the 
Raw Source window) 

VI body current line highlight bar 

Sign-On Screen 

Qk body background "wallpaper" 
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Configure \ Windows 







'The Windows command calls a Pull-down Menu from which you may 
modify, resize, jump into and repaint Main Screen Windows. The com- 
mands available are described after the following picture and descrip- 
tion of each type of Main Screen Window. 

The following picture shows how each type of Main Screen Window is 
displayed. 
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Register Window 

SRegister WindowTIie Register Window is used to display values for SFR's (Special Function Registers), 
GPR's (General Purpose Registers) and bits from the PSW (Program Status Word). The current 
microcontroller (defined by the SMODEL file in use) is displayed on the right side of the top border of 
the window. The currently selected Register Bank (0-3) is displayed on the left side of the top border of 
the window. The Register Window allows Change Mode (page 6-6) and is scrollable while in Change 
Mode. 

The values of the GPR's for the current Register Bank are displayed on the left side of the first line inside 
the window. The bits from the PSW, other than RSO and RSI, are displayed on the right side of the first 
line inside the window. The rest of the window is occupied by the SFR names and values. 



The data values of the SFR's and GPR's are displayed in hexadecimal and PSW bits are displayed in 
binary. 
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Stack Window 



The Stack Window is used to display values that have been pushed on the Stack. The value of SP (Stack 
Pointer) is displayed on the right side of the top border of the window. The Stack Window allows Change 
Mode (page 6-6) and is scrollable while in Change Mode. 

The data values in this window can be displayed in 'Hex only mode or in 'Hex + ASCII' mode. More data 
can be fit in a window in 'Hex only" mode as the raw hexadecimal data will extend to the right border of 
the window. The 'Hex + ASCII' mode uses the right part of the window to display the ASCII character for 
each data byte, or a period if the character is unprintable. The 'Hex only" mode is the default but can be 
changed under the Options column (page 7-18) of the Modify command. 

The starting address of data in the window is the value of SP and cannot be changed. Note that since the 
Stack on the 8051 device grows upward, the value pointed to by SP will be placed at the right of the 
displayed line of data. 

Bit Window 

The Bit Window is used to display the values of the RAM-bits (Bit Addressable Data Memory). The Bit 
Window allows Change Mode (page 6-6) and is scrollable while in Change Mode. 

The data values for this window are displayed in binary. 

The starting address of the data in this window is (by default) but can be modified by specifying a starting 
address under the Start Address column (page 7-17) of the Modify command or by scrolling the window 
in Change Mode. 

Internal Data Window 

The Internal Data Window is used to display the values in Indirectly Addressable Internal Data Memory. 
Up to five (5) Internal Data Windows may be used. The Internal Data Window allows Change Mode (page 
6-6) and is scrollable while in Change Mode. 

The data values in this window can be displayed in 'Hex only" mode or in 'Hex + ASCII' mode. More data 
can be fit in a window in 'Hex only" mode as the raw hexadecimal data will extend to the right border of 
the window. The 'Hex + ASCII' mode uses the right part of the window to display the ASCII character for 
each data byte, or a period if the character is unprintable. The 'Hex + ASCII' mode is the default but can 
be changed under the Options column (page 7-18) of the Modify command. 

The starting address of the data in this window is (by default) but can be modified by specifying a starting 
address under the Start Address column (page 7-17) of the Modify command or by scrolling the window 
in Change Mode. 

Note that for filling, comparing and writing (to a file) blocks of Internal Data Memory the Dis- 
play I Alter \Idata Window (page 7-38) is available. 

External Data Window 

The External Data Window is used to display the values in External Data Memory. Up to five (5) External 
Data Windows maybe used. The External Data Window allows Change Mode (page 6-6) and is scrollable 
while in Change Mode. 

The data values in this window can be displayed in 'Hex only' mode or in 'Hex + ASCII' mode. More data 
can be fit in a window in 'Hex only" mode as the raw hexadecimal data will extend to the right border of 
the window. The 'Hex + ASCII' mode uses the right part of the window to display the ASCII character for 
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each data byte, or a period if the character is unprintable. The 'Hex only' mode is the default but can be 
changed under the Options column (page 7-18) of the Modify command. 

The starting address of the data in this window is the address pointed to by DPTR (by default) but can be 
modified by specifying a starting address under the Start Address column (page 7-17) of the Modify 
command. 

Note that for filling, comparing and writing (to a file) blocks of External Data Memory the Dis- 
play/Alter \Xdata Window (page 7-38) is available. 

Code Window 

The Code Window is used to display values in raw Code Memory. Up to five (5) Code Windows may be 
used. The Code Window allows Change Mode (page 6-6) and is scrollable while in Change Mode. 

The data values in this window can be displayed in 'Hex only 5 mode or in 'Hex + ASCII' mode. More data 
can be fit in a window in 'Hex only' mode as the raw hexadecimal data will extend to the right border of 
the window. The 'Hex + ASCII' mode uses the right part of the window to display the ASCII character for 
each data byte, or a period if the character is unprintable. The 'Hex only" mode is the default but can be 
changed under the Options column (page 7-18) of the Modify command. 

The starting address of the data in this window is (by default) but can be modified by specifying a starting 
address under the Start Address column (page 7-17) of the Modify command or by scrolling the window 
in Change Mode. 

Note that for filling, comparing and writing (to a file) blocks of Code Memory the Display/Alter | Code 
Window (page 7-38) is available. 

Source Window 

The Source Window is used to display disassembled instructions in Code Memory. Change Mode is not 
allowed for the Source Window. The current module (see the Source/Symbols \ Current Module command 
on page 7-52) is displayed on the left side of the top border and the filename of the currently loaded 
program (see File \Load on page 7-27) is displayed on the right side of the top border. 

The information in this window may be displayed in 'Code Mode' or 'Mixed Mode'. 'Code Mode' means 
just an assembly language disassembly of the code will be displayed. 'Mixed Mode' means that HLL 
source lines (if available) will be displayed along with the disassembled code. The default is 'Mixed Mode' 
but can be changed under the Options column (page 7-18) of the Modify command. 

The starting address of the code displayed is at the PC address and cannot be changed. Note that during 
single step (Run \Step on page 7-34) or slow motion operation (Run \ Slow Motion on page 7-34) the 
starting address of the screen does not change until the flow of execution moves out of the code that 
appears in the window, at which time a new window full of code will be displayed. This is intended to keep 
the Dynamically Annotated Code (see page 6-5) visible as long as possible. 

Status Window 

The Status Window is used to display information during and after emulation. The Status Window allows 
Change Mode (page 6-6) but not all information in the window is changeable. 
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The information that is changeable (in Change Mode) follows: 



BrkCnt the number of break points to pass before breaking 

(see Break/Trace \ Break-Count on page 7-64) 

RepCnt the number of times to restart the program after a 

break (sec Run \Repetition Count on page 7-35) 

DPTR the Data Pointer (DPH and DPL) 

PC the Program Counter (PC) address 



The information that is not changeable (in Change Mode) follows: 

Time execution time in microseconds 

Resets the number of resets during execution from any 

source (Target reset, Watchdog Timer reset, etc.) 

State during emulation the method of starting the 

emulation (RESET,GO) and after break the type of 
break (Break-point, Host-break) 

BrkAddr the break address 

Trace (Model 400 emulators only) the amount of trace 

data captured during the most recent emulation 
(Empty, Partial, Wrapped) 

Read (Model 400 emulators only) the percentage of trace 

data transferred to the Host Computer 

Trig (Model 400 emulators only) the type of trace trigger 

used for the emulation (see Break/Trace \ Trace 
Trigger on page 7-64) 



Watch Window 



The Watch Window is used to keep track of program variables and/or registers during program execution. 
At each break the value of each item in the Watch Window will be updated. If a value has changed that 
value will be highlighted. Variables are added to the Watch Window using the Configure \ Window \Add 
command (page 7-19) and removed from the window using the Configure \ Window \Delete command 
(page 7-19). 



A modified Change Mode (page 6-6) is available 
window but not change any values. 



Watch Window that allows you to scroll the 
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Configure \ Windows \ Modify 
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The Modify command opens a window from which you may configure various attributes of the Main 
Screen Windows. The window lists (column-wise) the active status, order, start address and other options 
for each of the Main Screen Windows. The active windows are listed in the order they appear on the Main 
Screen and the inactive windows are listed below them and are de-emphasized. 

The f and I keys can be used to select which window (row) and the «- and -* keys can be used to select 
which attribute (column) to change. The current window attribute will be marked by the highlighted 
column header and the highlighted attribute. Note that not all attributes of each window may be changed, 
as described in the description of each window. A description of each attribute follows: 

Active 

The Active column shows the active status of each window. Pressing Y will activate the window and 
pressing N will de-activate the window. Pressing the Space or Enter keys toggles between active and 
inactive. If a window is de-activated its listing will be moved below all active windows listed. When a 
window is made active it will be made the last listed active window. 

Order 

The Order column shows the relative position of each window. The windows are always listed in their 
relative position. To change the relative position of a window, press the Space or Enter keys to call a Dialog 
Box to enter the new position number. You may also simply press the number you want to change the 
position to. The window will exchange places with the window previously at the position specified. 

Start Address 

The Start Address column shows the starting address (or the method of determining the starting address) 
of the data displayed in each window. The Register, Status and Watch windows have no specifiable start 
address. The Stack window always starts at the address pointed to by SP. The Source window always 
contains the code at the address pointed to by PC. The External Data window can be set to always start 
at the address pointed to by DPTR, or can be changed to start at a specific, fixed address, as can the 
remaining windows. 

To specify a start address (where applicable) press the Space or Enter keys to call a Dialog Box to enter 
an address. Pressing the Space or Enter keys while on the @DPTR symbol toggles the External Data 
window between the specified start address and starting at the address pointed to by DPTR. 



7-17 



Options 

The Options column shows the format that the data for a window is being displayed in. There are no 
options for the Bit, Status and Watch windows. For the Register Window pressing the Space or Enter keys 
calls a Dialog Box to allow you to specify the character used to separate the register name from the value. 
For the Source window pressing the Space or Enter keys toggles between 'Code Mode' (disassembled 
code) and 'Mixed Mode' (disassembled code and available HLL source). For all other windows pressing 
the Space or Enter keys toggles toggles between 'Hex only' (just hexadecimal data) and 'Hex + ASCII' 
(hexadecimal plus printable ASCII characters for all data) display modes. 

Configure \ Windows \ Size 

The Size command allows you to change the size of the Main Screen Windows and is equivalent to pressing 
Ctrl-R from the Main Menu Bar. After either command is selected the top window border will be 
highlighted to indicate that it is the window currently being resized. The computer will beep when the 
current window cannot be resized further. During the resize the following keys are active: 



t i move bottom border in indicated direction 

Esc abort resize, leave the window the size it was when 

the command was selected 

Enter accept new window size and advance to next 

window 

Tab advance to next window 

Shift-Tab return to previous window 



Configure | Windows | Goto 

The Goto command activates Change Mode (page 6-6) in the top window and is equivalent to pressing 
Tab or Shift-Tab from the Main Menu Bar. 

Once in Change Mode the following keys are active: 



t i 


move currently selected data item 


PgUp 


move up one window full of data 


PgDn 


move down one window full of data 


Home 


move to beginning of data 


End 


move to end of data 


Esc 


exit Change Mode 


Enter 


open a Dialog Box to enter new data 


Tab 


advance to next window 


Shift-Tab 


return to previous window 



Note also that pressing any alphanumeric character while in Change Mode will open a Dialog Box to enter 
new data. 
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Configure \ Windows \ Repaint 



The Repaint command repaints all Main Screen Windows and updates all data in each window. This 
command is useful if you want to update data values without having to go through an emulation (e.g., to 
check port pin values). 

Configure | Windows \Add 

Th&Add command is used to add a variable or register to the Watch Window. Selecting the command will 
call a Dialog Box for you specify the variable or register name to add. 

Configure \ Windows \ Delete 

The Delete command is used to remove a variable or register from the Watch Window. Selecting the 
command will call a Dialog Box for you specify the variable or register name to remove. 
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Configure \ Identification 



— iceM ASTER - 8852 

Firmware Version: 2.25: PROM Version: 1.18 

Software Version: 3.8 Rev 11 

Emulator Base: iceMASTER-8851 Model 488 

Model File Version: 3.814 

Emulator Memory : 64X Code, 64K External Data 

Accessible Addresses: 64K Code, 64K External Data 

Trace : 4K 

Performance Analyzer: High Resolution, High Bin Count 

Watchdog Timer (UDT) : Supported 



MetaLink Corporation 
Chandler, Ar i zona 

(c)Copyright MetaLink Corp. 1998,1991 

Press any key to continue 



The Identification command displays a box containing important technical information. If technical 
assistance is required from MetaLink, or if trouble develops with your emulator, the information 
presented on this screen will be very useful. 

Some items, such as amount of memory installed in the emulator, firmware version, and PROM version 
cannot be determined unless communication between the Host Software and the emulator base has been 
established. If a problem develops that prevents communication from being established this information 
would be unavailable; therefore, we recommend that you take a moment to record all pertinent informa- 
tion from this screen in the space provided below. It will then be available should you need it: 

Firmware Version 'i-r^^T tt^LJo- ^3 

PROM Version 

Software Version "5 3 b 

Emulator Base Type I ce MAoPOi -(oSJfC l| Mtftfa uev 

Model File Version 

Emulator Memory Installed 
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Configure \ Options 



The Options command calls a Pull-down Menu from 
which you may turn global options ON or OFF. The 
Alert group of options all relate to audio notification of 
events and are made permanent if the Config- 
ure | Save \Save command (page 7-25) is selected with 
the Configure \Save\Alert toggle (page 7-25) turned 
ON. The Miscellaneous options are made permanent if 
the Configure \ Save \ Save command is selected with the 
Configure \ Save \Misc toggle (page 7-25) turned ON. 

Configure \ Options \ Diagnostics 



y.lil File Bun Display/Alter 
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Bad key/command 
Host— break 
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On 
On 



B8A7 7« 



Flicker On 

Trace prefetch On 

Main Esc On 

Connon Window Borders On 

Stack Hyper 1 inks On 

Pronpt OS-Escape On 

Unknown data type size 1 



Toggle beeping ON and OFF when error messages, warning messages and important information are 
displayed. 

Configure \ Options \ Bad key/command 

Toggle beeping ON and OFF when an invalid key is pressed or an inactive command is selected. 

Configure \ Options \ Host-break 

Toggle beeping ON and OFF when a Host-Break (Esc) is issued during emulation. 

Configure \ Options | Flicker 

Toggle ON and OFF flickering used to indicate which choice was made in a Confirmation Box. 

Configure | Options \ Trace prefetch 



Toggle ON and OFF trace prefetch. If ON, the trace data is prefetched (read) whenever the keyboard is 
inactive and there is trace data to upload from the emulator to the Host Computer. Pressing a key during 
prefetch will interrupt the read (after a slight delay). If OFF, trace data will be fetched (read) only when 
you move around in the Break/Trace \ View Trace window (page 7-65) to look at different parts of the trace 
buffer. There may be a slight delay as you look at different areas of trace memory. 



Configure \ Options \ Main Esc 

Toggle ON and OFF the Main Escape feature. If ON, you may exit the Host Software from the Main Menu 
Bar by pressing Esc. If OFF, you may exit the Host Software only by selecting the File \ Exit command (page 
7-32). In either case you will have to exit through a Confirmation Box. However, if you use the Hot Key 
assigned to File \Exit, Alt-X, no Confirmation Box will be displayed; exit is immediate. 
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Configure \ Options \ Common Window Borders 



Toggle ON and OFF the Main Screen Window common borders. If ON adjacent Main Screen Windows 
share a common bottom and top border. If OFF all Main Screen Windows are framed with complete, 
separate borders. 

Common Window Borders ON is the default so as to minimize the number of screen rows used for window 
borders and to maximize the amount of information displayed. However, when ON you will find that you 
probably want to configure the windows to have the same border line style and the same background color. 

When OFF, this fr amin g style uses more screen rows for window borders. However, if you choose to select 
different border line styles and/or background colors for each window, the results will be more pleasing 
visually. 

Configure \ Options \ Stack Hyperlinks 

Toggle ON and OFF the Stack Hyperlink feature. Stack Hyperlinks controls the behavior of the Help 
System when a new Help Topic is invoked via a hyperlink: 

If ON, when you select a new Help Topic via a hyperlink in the current Help Topic, the host software 
"remembers" your position in the current Help Topic. When you exit that new Help Topic, you return to 
the "remembered" position in the current Help Topic. This process applies recursively. 

If OFF, when you select a new Help Topic via a hyperlink in the current Help Topic, the host software does 
not "remember" your position in the current Help Topic. When you exit that new Help Topic, you exit the 
Help System. 

Configure | Options \ Prompt OS-Escape 

Toggle ON and OFF the OS-Escape DOS prompt. If ON, during an OS-Escape, your DOS prompt will 
be augmented with a reminder of how to get back to iceMASTER. This reminder, added to the end of 
your normal DOS prompt, consists of the string: 

(type 'exit' to return to iceMASTER) 

If OFF, during an OS-Escape, your DOS prompt is left as is. 

Configure \ Options \ Unknown data type size 

The Unknown data type size command sets the number of bytes to display for the value of an unknown 
data type in the Source/Symbols (page 7-53) group of displays and in the Watch Window. The current 
number of bytes to display is shown next to the command. 



7-22 



Configure \ Function-Keys 



'onf igure 



File R 



The Function Keys command calls a Pull-down Menu from which you may 
change the number Function Key label lines displayed and change Function 
Key assignments. 

Configure \ Function-Keys \ Lines 

The Lines command toggles the number of lines of Function Key (Hot Key) 
labels displayed at the bottom of the screen. This feature can be disabled 
(zero lines) or you may display up to four lines. If more than one line is being 
displayed, the character in the first column shows which key combination to 
use for that row of Function Keys, as follows: 



Emulator 

— Mapping — 
Code Memory 
Xdata Memory 

Display — 

Attr ibut.es 
U i ndous 



I dent if ication 
Options ► 
"T - 




A 
C 

s 



Alt Key 
Ctrl Key 
Shift Key 



Regardless of the number of lines of Function Key labels displayed at the bottom of the screen, all 40 
Function Keys are still available for use. 

Configure \ Function-Keys \ Modify 



onf igure 



File Run Display/Alter Misc Source/Symbols Break/Trace Help 
Funct ion Key Assignment 
Clear Display Save Urite Help 



Assignments 



Help 
ResetEm 
ResetTg 
Go 

GoFrom 
GoUntil 
Step Ins 
StepLin 
StepOur 
Step To 
Load 
SetBkpt 
View Ire 
DisAssn 
MacExec 
" Ctrl 
Assign current optio 



Fl 
F2 
F3 
F4 
F5 
F6 
F7 
F8 
F9 
FIB 

Shift-Fl 
Shift-F2 
Shift-F3 
Shift-F4 
Shlft-F5 



Options 



UnModfy Conf igure !U i ndous ! Modify 

UnResiz Conf igure !U i ndous !S ize 

UnSelct Conf igure illindous ! Goto 

UnRepnt Conf igure I U i ndous I Repa int 

AddUtch Conf igure I U i ndous ! Add 

DelUtch Conf igure lUindous! Delete 

Load FileSLoad 

DounLod Fi le ! Download 

MacExec Fi le ! Macro ! Execute 

ResetEm Run! Reset (emulator) 

ResetTg Run! Reset (target) 

Go Run ! Go 

GoFrom Run! From 

GoUntil Run! Until 

GoSlou RuniSlou Motion 

R:Resize Ctrl-U:Moue Tab.Shif t-Iab :Select 
i to current Function Key 



The Modify command calls a Menu Bar Window from which you may reassign any of the available 
functions to any of the 40 function keys. The window on the left side of the screen (labeled Assignments) 
shows the current assignments. The window on the right side of the screen (labeled Options) shows the 
commands available for assignment. The Tab key may be used to toggle between the two windows to scroll 
within each window. The commands are: 
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Configure \ Function-Keys \ Modify\Assign 



The Assign command actually makes the assignment. Highlight the desired Hot Key, 
press Tab to change to the Option Window, then highlight the desired command and 
then select the Assign command. When you select Assign, the highlighted Hot Key is 
paired with the highlighted Option. To accept any changes for the duration of the current 
session it is necessary to save the assignment using the Configure \ Function-Keys {Mod- 
ify \Save command. To make the changes permanent it is necessary to save the changes 
to the SFKEYDEF file using the Configure \ Save] Save command (page 7-25). 

An alternate method of assignment is to highlight the desired command in the Options 
Window and then type the Function Key you wish it to be assigned to. For example, to 
assign Hot Key Alt-FlO to the Run ] Reset \ Emulator command, highlight that command 
in the Options Window and then press Alt-FlO. The assignment is now made. 

Note that if you try to reassign the Hot Key for Help (by default Fl) you will be forced 
through a Confirmation Box to determine if your intention is to reassign the Hot Key for 
Help or just to view Help information. 

Configure \ Function-Keys \ Modify \ Clear 

To clear the assignment of a given Hot Key, highlight it and then select the Clear 
command. 

Configure \ Function-Keys \ Modify \ Display 

The Display command changes how Hot Key information is displayed. The assignment 
procedures are the same, but the information is presented in a slightly different format, 
by default the short description of the command (which is displayed in the Function Key 
Label Lines) is shown next to the Hot Key in the Assignment Window. This command 
allows you to display the long description (the full command sequence) next to the Hot 
Key in the Assignment Window. 

Configure \ Function-Keys | Modify \ Save 

The Save command preserves the changes you have made for the current session. To 
make these changes permanent, you must select the Configure] Save \ Save command 
(page 7-25) with the Configure] Save] Function-Keys (page 7-25) turned ON. This will 
write or update the SFKEYDEF file. If this file is present during Host Software 
initialization, Function Key assignments are read from it. 

Configure \ Function-Keys | Modify \ Write 

The Write command writes all current Function Key assignments to a disk file. The file 
is written in plain ASCII human-readable text so that you may print a copy of the file for 
reference. 
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Configure \ Function-Keys \ Modify \ Help 



The Help command is available to give you quick, direct access to the Help System. If, 
however, you press the Hot Key assigned to Help you will be forced through a Confir- 
mation Box to determine if your intention is to reassign the Hot Key for Help or just to 
view Help information. 

Configure | Save 



The Save command calls a Pull-down Menu which allows you to 
save or update various user interface configuration options. You 
May toggle each of the category types ON or OFF so that only the 
selected changes are saved to a disk file (e.g., you may wish to save 
your current window and menu color choices in SCOLOR, but not 
temporary changes to the number of screen lines). 

Configure \ Save \ Save 



This command saves information about each option whose Save 
option is ON into a specific file. 

Configure | Save \ Alert 

When ON, Alert enables saving your Configure \ Options Alert option (page 7-21) choices to the SALERT 
file. 

Configure \ Save | Colors 

When ON, Colors enables the saving of your color option choices to the $COLOR file. This file contains 
the user selected screen display attributes from the Configure \Attributes\ Select command (page 7-9). 

Configure \ Save \ Function-Keys 

When ON, Function-Keys enables the saving of your Hot Key assignments to the SFKEYDEF file. 
Function Key assignments can be changed using the Configure \ Function-Keys \Modify menu (page 7-23). 

Configure \ Save \ Lines 

When ON, Lines enables the saving of the number of screen lines (video mode) to the SLINES file. The 
number of screen lines can be changed (depending on video adaptor installed) using the Configure Attri- 
butes \Lines Pull-down Menu (page 7-8). 

Configure \ Save \ Misc 

When ON, Misc enables the saving of your (Configure | Options) Miscellaneous option (page 7-21) choices 
to the $MISC file. 
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Configure \ Save | Windows 

When ON, Windows enables the saving of window size and position information to the SWINDOW file. 

Configure | Restore 

The Restore command restores configuration choices previously saved using the Configure \ Save \ Save 
command (page 7-25), without exiting and reentering the Host Software. If you make temporary changes 
to some user interface configuration option, you may restore your permanent choices with this command. 
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File 



^Tfg Run Display/Alt 



The File command calk a Pull-down Menu from which you may load a 
program, save or restore the emulation environment, upload and 
download code and data to (or from) your target system, create and 
execute macros to automatically handle frequently repeated tasks, tem- 
porarily exit to DOS from the Host Software and Exit the Host Software. 
The commands available are: 









Store 
Restore 




► 
► 


Upload 
Download 






Macro 






OS Escape 


Alt-0 




Exit 


Alt-X 





The Load command allows you to load a program into the emulation environment. The special Filename 
Dialog Box is used to prompt you for the filename (see the Software Guide). Remember that a directory 
listing is available using the ? (terse) and ! (verbose) commands. 

After a valid file name has been entered, a Confirmation Box will ask if you wish to 

Merge into the current application environment? 

If you answer Y then all breakpoint, map, and trace (Model 400 emulators only) settings will be kept, and 
the code and symbols in your program will be merged with any existing program. Code at conflicting 
addresses from the new file will overwrite the same code in the old file. All symbolic and HLL information 
from the old file will remain and any such information in the new file will be added. 

If you answer N the previous environment including break, trace (Model 400 emulators only), and code 
memory will be cleared or restored to default settings before the new program is loaded. Pressing Esc 
cancels the Load operation. 

Please note that this command only loads your program into the Host Computer and the emulator's code 
memory. If your target system is set up in a Von Neuman configuration (#PSEN and #WR 'anded' 
together), and you wish the code to be placed in target RAM, you should use the File \ Download command 
(page 7-29). 

While your program is being loaded, you will see address ranges displayed on the right of the Quick Help 
Line and source line and module information on the left, if found. Assembly language programs will never 
have line number information. 

If your HLL generated program doesn't display source line or module information, you should check to 
be sure that the source files can be found in the HLL search path (see Source/Symbols {Source Path on 
page 7-52). If the HLL search path is set properly refer to Recommended Compilation Options (Appen- 
dix H) to verify the compilation and linker options. 
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Filestore 



The Store command allows you to store the emulation 
environment to a file for later recall by the File {Re- 
store command (below). You will be prompted for the 
filename by a Filename Dialog Box. 

While the Store operation is taking place a Status Box 
will display each item as it is being saved. The emula- 
tion environment is defined by: 

Current PC (program counter) 
Code map 
External Data map 
Internal Data memory 
SFR values 

External Data memory 
Code memory 
Code file name 
HLL search path 
Symbol table 
Breakpoint settings 



Load 



Run Display/Altar Misc Source 

—Reg isters 

:B8 R6:00 R?:00 

DFL 08 IE 

P3 FF PC( 



Shift-Fl ► 



Application Environment^ 
Saving Instruction Pointer 
Saving Code Map 
Saving External Data Hap 
Saving Internal Data Memory 
Saving SFR' s 

Saving External Data Memory 
Saving Code Memory 
Saving Code File Name 
Saving HLL Search Path 
Saving Symbol Table 
Saving Breakpoints 



If the device being used can access external data memory, a Dialog Box will ask how many K bytes to save 
(from 0-64 valid). 



File | Restore 



Run 



The Restore command is used to restore the em- 
ulation environment from a file saved using the 
File\Store command (above). You will be 
prompted for the filename by a Filename Dialog 
Box. 



Store 



Display/Alter Misc Source/Sn 

—Reg isters 

:08 R6:88 R?:88 CV 

DPL 00 IE 

P3 FF PCON 

SP 24 T2C0N 



Shift-Fl ► 



=Restore Application Environment= 
Restoring Instruction Pointer 
Restoring Code Map 
Restoring External Data Map 
Restoring Internal Data Memory 
Restoring SFR's 

Restoring External Data Memory 
Restoring Code Memory 
Restoring Code File Name 
Restoring HLL Search Path 
Restoring Symbol Table 
Restoring Breakpoints 
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File\Upload 



The Upload command allows you to upload code memory from the target system into the emulator's code 
memory space, where it can be modified. When you select this command you will be asked for the range 
of addresses you wish to upload. After responding a Confirmation Box will ask: 

Merge into the current application environment? 

A Y answer will cause existing code within the specified upload range to be overwritten by the uploaded 
code. Current breakpoints and labels will be retained as will trace ON/OFF (Model 400 emulators only) 
points and HLL line number references. 

A N answer will clear all of the emulation environment settings currently in effect along with code memory 
and any symbolic or HLL line number references. 

File | Download 

The Download command is used to download code or external data from a file on the host computer to 
the target system. You will be prompted for the filename by a Filename Dialog Box, and after entering a 
valid filename a Confirmation Box will ask: 

Are you downloading code memory? 

A Y answer means download to the target board's code memory and a Confirmation Box will ask: 

Merge into the current application environment? 

A Y answer merges information from the file into the current application environment and N clears the 
application environment before loading information from the file. For more information on the merge 
prompt see the File \ Load command (page 7-27) . Note that your target must be designed as a Von Neuman 
architecture (#PSEN and #WR 'anded' together) to actually download any code to the target system 
memory. 

A N answer to the download prompt means download to the target board's external data memory. The 
information from the file will be downloaded to the target board. If the file contains symbolic information, 
all symbolic information will be ignored. 

On the surface, it may not seem necessary to worry about the emulation environment if you are 
downloading code to the outside world, but the Host Computer must know if it is to clear symbolic 
information, breaks, or Trace ON/OFF points (Model 400 emulators only) from the emulator at load time. 
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File | Macro 



The Macro command calls a Pull-down Menu from which you may 
create and execute macro command files. A macro command file 
contains a series of recorded keystrokes which, when executed, per- 
form a macro function. A macro command file may be used to auto- 
mate long or repetitive tasks. 

Macro Environment 



When the emulator is in macro learn mode, all keystrokes typed are 
saved to a disk file in order to be reproduced (executed) at a later time. 
Not only are the keystrokes saved, but the Function Key assignments at 
macro creation time are saved as well. Because of this, Function Key 
keystrokes will perform the commands assigned to them at the time the macro file was created. If the 
Function Keys have been redefined, the user may notice that the macro file Function Keys may not 
perform the same tasks as the currently defined ones. At macro completion, the Function Keys will be 
returned to their redefined values. 

Note that for macro files that may be used over a long period of time it would be wise to avoid using cursor 
keys to select commands and to always use the Quick Key (the highlighted letter of the command). This 
would be useful in the situation where a Host Software update occurred where several commands have 
been added. Execution of a macro file using cursor keys may get 'out-of-synch', meaning because of the 
extra commands, commands other than those intended may be selected. 

Parameter Substitution 

If the same task needs to be performed repeatedly, but values may change between runs, the same macro 
command file can be executed using parameters. In general, parameters can be used anywhere you are 
prompted for information (filenames, numeric values, addresses, etc.). When creating a macro command 
file, a %P (see the File \Macro \Leam command below) is keyed in wherever a parameter value is to be 
used. When a macro command file is executing, it substitutes a parameter value whenever the %P 
keystroke combination is encountered. A parameter list may be supplied when invoking the macro 
command file (see the File \Macro {Execute command below). During macro execution, if no parameters 
are supplied and %P is encountered, execution stops until a parameter is provided. 

File\ Macro | Execute 

The Execute command begins execution of the commands in a macro command file created using the 
Learn command. After entering the name of a valid macro command file you will be prompted for any 
parameters to pass to the macro command file. 

All parameters should be listed in the order that they are used in the macro command file. Each parameter 
will be prompted for separately. Pressing Enter in response to a parameter prompt (without entering any 
data) will start execution of the macro command file. 

Commands are executed from the macro command file until the end of the file is reached or Ctrl-C is 
pressed. Control then returns to you (manual entry). 

Note that you may use the command line option (Appendix J) to start automatic execution of a macro 
command file when you invoke the Host Software. 



mr3 Hun Display/Alt. 



Load Shift-Fl ► 

Store ►■ 

Restore ► 

Upload ► 

Download ► 

Learn ► 

Delay 8 K 

Repeat 8 K 
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File | Macro \ Learn 



The Learn command is used to create a macro command file. After entering a valid file name control is 
returned to the Main Menu Bar and the system enters Learn Mode. In Learn Mode every keystroke 
entered is stored in the macro command file until %E (see Learn Mode Commands below) is entered. All 
Host Software commands are accessible in Learn Mode except for the File \Macro command. 

Learn Mode Commands 

End macro learn mode 

Insert a % sign in the macro file as normal text. 

Parameter substitution. Everything typed up to the next 
Enter will be passed to the program and not included in the 
macro file. When the Enter key is pressed, Learn Mode 
resumes. During execution a parameter will be pulled from 
the parameter list or, if no parameters are present, the 
emulator will wait for the user to supply one. 

Enter a delay. Everything typed up to the first non-digit 
character is a real-time delay (in milliseconds). This delay is 
not the same as the global delay (File \ Macro] Delay). This 
delay is used only between the keystrokes in which it was 
entered in the macro file. This local delay is added to the 
global delay, if one was specified. 

Execute a new macro. Everything typed up to the Enter is the 
name of a new macro file. If entered during Learn Mode, the 
macro command file is closed and Learn Mode ends. If 
entered during execution of a macro, the current macro 
command file is closed, the new macro command file is 
opened, and execution continues from the new file. 

NOTE: No keystrokes will be echoed to the display when entering Learn Mode command information. 
Any other % key combinations will be ignored. 

File\Macro\Delay 

The Delay command is used to set a global delay time (between each keystroke) during macro command 
execution. Valid delay times range from to 15000 milliseconds (15 seconds). The default value for the 
global delay is 0. 

File I Macro \ Repeat 

The Repeat command is used to set the number of times that the execution of a macro command file is to 
be repeated. Valid repeat counts range from to 60000. The default repeat count is 0. 



%E 



%D 
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File\OS-Escape 



The OS-Escape command temporarily exits the Host Software to DOS while keeping the Host Software 
system intact. An error message will be reported if there is not enough memory available to escape to 
DOS. This may happen if a program is loaded with a large amount of symbolic information or if many 
TSR's are loaded on the Host Computer. After completing your DOS tasks, type exit to return to the Host 
Software. 

By default the OS-Escape command adds the prompt 

(Type exit to return to iceMASTER) 

to your DOS prompt. Note that if you do not want to modify your DOS prompt, this feature may be 
disabled using the Configure | Options \ Prompt OS-Escape command (page 7-22). 

File\Exit 



The Exit command allows you to exit the Host Software. Note that it is also possible to exit the Host 
Software from the Main Menu Bar by pressing Esc if the Configure | Options | Main Esc option is ON (page 
7-21). In either case you will be forced through a Confirmation Box to confirm your intention to exit the 
Host Software. 

Alternatively, if you use the Hot Key assigned to File] Exit (Alt-X), exit from the Host Software is 
immediate, without the Confirmation Box. 
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Run 



iiTOI Di splay /A Iter Misc Sou 



The Run command calls a Pull-down Menu from which you can 
select commands to begin or resume emulation (execution of 
your program in the emulator). The commands are: 



Go 




Go F4 

From FS ► 



Until F6 ► 
Slow Motion Alt-F7 
Step — 



Step F7 

Line F8 

Over F9 

To FIB 



Run | Reset 



Repetition Count Alt-F8 1 ► 




iiTTffl Display/Alt 



The Reset command calls a Pull-down Menu from which you may select one of 
the three types of Resets available. They are: 




rf 



Run | Reset \ Processor 



Enulator F2 
Target F3 



The Processor command resets the microcontroller in the probe card to its 

Reset state. Unlike the Emulator and Target commands (below), emulation does not actually begin. 

Run | Reset \ Emulator 

The Emulator command starts emulation from a device Reset condition. The Reset signal comes from the 
emulator and occurs automatically. There is no output to synchronize the target system, as the reset pin 
to the target is input only. Some devices have a Reset out signal on a separate pin. This signal, if present 
in the microcontroller itself, will be available. 

Run\Reset\Target 

The Target command also starts the microcontroller from a Reset condition, but the source of the Reset 
signal is the target system or the Reset button on the emulator. Emulation will not begin until the Reset 
signal is supplied. 



The Go command begins (or restarts) emulation starting from the current program counter (PC) address. 
If the emulation session is started with a Go command from an unknown state (i.e., without having been 
Reset first, unpredictable behavior may result. 



The From command allows you to begin (or restart) emulation at a program counter (PC) address which 
you will be prompted to supply. Aside from changing the program counter (PC) address, this command 
works just like the Go command (above). 



Run | Go 



Run I From 
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The Until command allows you to set a temporary, simple breakpoint which is valid for one emulation 
cycle only. When selected, a Dialog Box will prompt you for the temporary breakpoint address. No other 
breakpoint which may be set is affected. When the emulation begins, the first active breakpoint encoun- 
tered will halt execution in the usual manner and this temporary breakpoint will be cleared. Aside from 
setting the temporary breakpoint address, this command works just like the Go command (above). 

Run\Slow Motion 



The Slow Motion command starts an automatically repeated cycle of Run | Step commands. This is not 
real-time emulation, since the system executes only one instruction, then breaks and updates the Main 
Screen Windows, then continues. A Slow Motion emulation is stopped by pressing Esc. 

After each instruction, the right side of the Source Window is used to display memory and register 
contents and program flow information. This is referred to as Dynamically Annotated Code (page 6-5). 

The speed of operation of the Slow Motion emulation is under your control as well. While operating in 
Slow Motion, use the + and - keys (on the keypad) to speed up or slow down the speed of execution. The 
delay between each Step can be varied from 100 to 2,000 (.1 to 2 seconds) and the default is 500 (.5 
seconds). The current delay value is shown in the Status Window as the state. When changing speed, note 
that only one change increment is allowed per Step. 

The Slow Motion command updates the entire display after each instruction. If you do not need real-time 
speed, this mode used in conjunction with the Watch Window, allows you to identify problems with 
unexpected data values or register value changes. All other break conditions are de-activated. 

flun I Step 

— -I— ^ «— — 

The Step command is a Single Step and is used to execute one assembly (machine language) instruction 
and then break emulation. The instruction that will be executed is at the PC address. 

An additional note on Single Step operation: This is not, strictly speaking, real-time emulation. Timer-re- 
lated programs may not operate correctly when single stepped. This may also include edge-triggered 
interrupts, serial port functions, and timer operation. See Chapter 8, Run-Time Considerations for 
additional information. 

Run | Line 



The Line command is used to Single Step by source line number. Emulation begins at the current PC and 
breaks when execution reaches the next source line of any module. 

Run I Over 



The Over command is used to Single Step by source line number. Emulation begins at the current PC and 
breaks when execution reaches the next source line of the current (same) module. This has the effect of 
"stepping over" calls to procedures or function in other modules. 
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Run | To 



The To command is used to Single Step by procedure or function entry points. Emulation begins at the 
current PC and breaks when execution reaches the next function, procedure or global code label. Note 
that global (public) code labels are included only because not all language processors (compilers) mark 
procedures and functions properly in the load file (see Appendix G, HLL Support Of Third Party 
Software). 

Run I Repetition Count 

The Repetition Count command is used to specify how many emulation cycles will occur after the next 
run-type (Reset, Go or Step) command is issued before emulation stops completely. After a breakpoint is 
encountered, emulation will halt for a moment, the data in all Main Screen Windows will be updated and 
if the repetition counter is non-zero, it is decremented and execution will continue. If the repetition 
counter is zero at this point, emulation will not be continued. The repetition counter may be set to any 
value between to 65535, inclusive. 

Host-break 



While code is executing in the emulator, regardless of how it was started (Reset, Go or Step), the Esc key 
can be used to force the emulator into break Condition. The break occurs at the nearest opcode fetch. The 



Host-break 

is displayed for the state in the Status Window. The Trace Trigger (see Break/Trace \ Trace Trigger on page 
7-64) is forced to End. Pressing the Break push-button on the emulator chassis during emulation is 
equivalent to pressing Esc during emulation. 
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The Display /Alter command calls a Pull-down Menu from which you may 
assemble new code into memory, disassemble existing code memory, 
view/change variable and register contents, view/change RAM-Bits, 
view/change raw Code, External Data and Internal Data memory. The 
commands are: 



Display I Alter \ Asm/Dasm 



isplay/Alter 



Hisc 



sn/Dasn SIlift-F4 ► 



emor' 

=ode Alt-FZ ► 

Jldata Alt-F3 ► 

Xdata Alt-F4 ► 



Jar /Reg Alt-F5 



RAM-Bits Alt-F6 



The Asm/Dasm command calls a Menu Bar Window from which you may assemble instructions into code 
memory and disassemble existing code memory. By default the Disassemble Mode is active on the first 
entry to the window but on subsequent entrances to the window the active mode will be whichever mode 
(Disassemble or Assemble) was active on the most recent exit from the window. The label in the center 
of the top border of the window shows the current active mode. 

The right side of the top border line (under the Menu Bar) shows the filename of any loaded code file. 
The left side of the bottom border line shows the Display Mode. The center of the bottom border line 
shows current key information. The right side of the bottom border line shows the Label-synch mode. The 
commands are: 



Display /Alter \ Asm/Dasm \ Disassemble 



Configure File Run 



isp lay/A 1 ter 



Disassemble Assemble 

— Module :F_HLMA IN 

Addr Code Label 



Misc Source/Symbols 
»b ler 



Break/Trace Help 



Mode 



B8A8 
08 A 1 
00 A3 
88 A5 
08A7 
08A9 
00 AC 
00AF 
00B2 
88B4 
88B6 
88B7 
00B9 
88BA 
IBC 



E4 

F521 

F52B 

C298 

7F8A 

120BB7 

1280EC 

1288EC 

8520 

88EF 

22 

8F24 
E4 

F522 
C3 

e=Code 



MAIN: 



INNERLOOP : 



Labe 1 -synch Ur i te 

-Fi le :\im51demo\f _demo .ao 



Instruct ion 



Start: 1 



CLR 
MOU 
MOU 
CLR 
MOU 
LCALL 
LCALL 
LCALL 
INC 
SJMP 
RET 
MOU 
CLR 
MOU 
CLR 
= PgDn 



A 

STATE, A 
COUNTER, A 
Pl_8 
R7,tt8Ah 
_ INNERLOOP 
UASTETIME 
WASTE TIME 
COUNTER 
88A5h 

REPEAT_CNT,R7 
A 

I, A 

C 

Next Screenful 



lad 


1 ^SSIS 


^^3jB DisAssn 


sip 




u?H2!B HI 



;f_hlmain:«33 

:F_HLNAIN:»35 
;F_HLNAIN:tt36 
;F_HLMAIN:»37 

;F_HLMAIN:tt38 

;f_hlmain:»39 

;F_HLMAIN:«48 
;F_HLMAIN:*42 

;f_ inner: ui4 

;F_INNER:»18 



=Label-Synch=0f f= 



The Disassemble command turns on Disassemble Mode. In this mode you can quickly view a page of 
disassembled code from anywhere in code memory by typing an absolute code address or a symbolic name 
(line number or label), or can scroll through code memory (disassembling a page at a time) using the PgDn 
key. When Disassemble Mode is made active a window full of code will be displayed. 

The disassembled code will be interspersed with HLL source images (if available) if the 'Mixed' display 
Mode is active. 

Note that if an absolute address is entered and the Label-synch Mode is OFF, the address may or may not 
correspond to an instruction boundary and may result in an 'out-of-synch' disassembly. 
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Display I Alter \ Asm I Dasm \ Assemble 



Configure File Run £ 



i sp 1 ay" A 1 ter 



Misc Source/Symbols 



Break/Trace Help 



Disassemble Assemble 

—Module :F_HLMAIf+ 

Addr Code Label 



Mode Label-synch Urite 

^ — ~"~~~~Fi le :Nim51demoVf _demo .aom* 



Instruction 



08B7 8F24 
B8B9 E4 
08 BA F522 
88 BC C3 
88BD E524 
88 BF 6488 
B8C1 F8 
B8C2 E522 
88C4 6488 
B8C6 98 
B8C7 5822 
B8C9 1288EC 
B8CC 389804 
B8CF C29B 
B8D1 8882 
Mode =Code= 



INNERLOOP : 



Start: 
leu Instruction 3 



Assembly Mode 



MOU 
CLR 
MOU 
CLR 
MOU 
XRL 
MOU 
MOU 
XRL 
SUBB 
JNC 
LCALL 
JMB 
CLR 
SJMP 
= At 



OU REPEAT CNT,S 



R 
A 11 
I, A 

C 

A.REPEAT_CNT 
A,lt88h 
R0,A 
ft. I 

A,888h 

A,R0 

BBEBh 

UASTETIME 

Pl_0.80D3h 

P1_0 

B8D5h 

Inc'Dec Start 



INNER :*14 
INNER :91S 



;F_INNER:ttl9 
;F_INNER:tt2B 
;F INNER :*21 



=Label-Synch=Off= !l 



TheAssemble command turns on Assemble Mode. In this mode you may enter new instructions into code 
memory a single line at a time. The assembler may also be used to add a label at a specified PC address. 
The PC address at which to add the instruction may be specified by typing an absolute code address, a 
symbolic name (line number or label) or by using the i and t keys to increment and decrement the 
address. When Assemble Mode is made active the current disassembly data is left in the window for 
reference. 



When entering an instruction, symbolic information may be used. This includes the ability to define a new 
label at the current address and using symbolic names in the operand part of the instruction. When a new 
label is entered, it is inserted into the internal symbol table as a global (public) symbol. 

Note that if the assembled instruction does not contain the same number of bytes as the original 
instruction at the current address you will be notified and asked to verify the operation through a 
Confirmation Box. 



Display/Alter\Asm/Dasm \ Mode 

The Mode command is used to toggle the display mode between 'Code' Mode and 'Mixed' Mode. The 
'Code' display Mode means that just assembly language instructions are displayed. The 'Mixed' display 
Mode (available only if HLL source is available) means that HLL source images are interspersed with the 
assembly code. 



Display/Alter\Asm/Dasm | Label-synch 



The Label-synch command is used to toggle label synchronization ON and OFF. When Label-synch is ON, 
the software uses existing code labels to verify that disassembly addresses are on instruction boundaries. 
If they are not the software will adjust the address so the disassembly begins on an instruction boundary. 
If the Label-synch mode is OFF, no such checks are made and the disassembly will start at the specified 
address. 



Note that if Label-synch Mode is OFF, the specified address may or may not correspond to an instruction 
boundary and may result in an 'out-of-synch' disassembly. 
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Display/Alter\Asm/Dasm \ Write 



The Write command is used to write the 
of the information written to that 
in the current display mode. 



led contents of code memory to a disk file. The format 
screen (i.e., in human-readable form), 



Display/Alter 
Display/Alter 
Display/Alter 



Code 
Idata 
Xdata 



The Code, Idata and Xdata commands call 
Menu Bar Windows which are used to per- 
form nearly identical functions, only on three 
separate memory spaces (Code, Indirectly 
Addressable Internal Data and External 
Data). Where the functions differ, the de- 
scriptions will be separate. In general, these 
commands are intended to manipulate raw 
memory in various ways. 

Note that the Xdata command will be de-acti- 
vated for devices that have no ability to access 
External Data Memory. 



i splay /'A Iter 



Misc Source/Symbols Break/T 



AsnDasM Shift-F4 MR?: 88 CV:8 AC: 8 FB:8 

nory ||b IE 48 I0C0N--B8 

KIIS^H2||F FCON 18 PSW 88 




ieu/Chartge Code Henory= 
Fill Move Compare 



Urite 



Address 8888 



8888 82 88 FD 88 88 88 88 88 ▼ 

8888 88 88 88 88 88 88 88 88 I 

8818 88 88 88 B8 88 88 88 88 § 

8818 88 88 B8 88 88 88 88 88 if 

8828 88 88 88 B8 88 88 88 88 ;ij 

8828 88 88 88 88 88 88 88 88 j| 

8838 80 88 88 88 88 88 88 88 . 

8838 88 88 88 88 88 88 88 08 1 

Ctrl-R.Resize Ctrl-M:Moue " 



The commands available are: 



Display/Alter Code \ Browse 
Display/Alter ldata\Browse 
Display /Alter Xdata\Browse 



The Browse command is used to enter Browse Mode. In Browse Mode you can scroll through memory by 
using any of the keypad cursor keys or can type an address (absolute or symbolic) to quickly view an area 
in memory. Note that Browse Mode may also be entered automatically from the Menu Bar by pressing 
any of the keypad cursor keys (except the «- and -» keys). 

Once in Browse Mode, you may switch between Browse Mode and Change Mode (page 6-6) by pressing 
the Tab or Shift-Tab keys. In Change Mode you may scroll through memory in the same manner as Browse 
Mode but may change the value of a memory address. When positioned at the desired address, pressing 
the Enter key or any alphanumeric key will call a Dialog Box to enter a new value to store at that address. 



Display/Alter Code \ Fill 
Display/Alter Idata] Fill 
Display /Alter Xdata\Fill 



The Fill command lets you quickly fill a block a memory with some value (or values). Selecting the Fill 
command calls a Dialog Box to prompt for the address range to fill and the pattern to fill that range with. 

The fill pattern may contain one or many values up to a total typed length of about 80 characters. If 
multiple values are needed, they must be separated by commas or spaces. Numeric values are by default 
hexadecimal and ASCII literals must be quoted (e.g., use 'A' to put the ASCII value of A in memory). The 
allowed characters in a fill pattern are listed in Appendix D, Character Sets. 
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Display/Alter 
Display/Alter 
Display/Alter 



Code | Move 
ldata\Move 
Xdata\Move 



The Move command is used to move (copy) a block of memory to another location in memory. Selecting 
the Move command will call a Dialog Box to prompt for the address range for the source block and for 
the starting address of the target block. 

Display/Alter Code \ Compare 
Display/Alter Idata \ Compare 
Display/Alter Xdata | Compare 



The Compare command is used to compare two blocks of memory. Selecting the Compare command will 
call a Dialog Box to prompt for the address range of one block and the starting address of the second 
block. If the blocks are the same a message will inform you of that. If the blocks are not the same, the 
addresses and values of the mismatches will be displayed, along with a count of the total number of 
mismatches found. 

Display I Alter I Idata \ Write 
Display/Alter\Xdata \ Write 

The Write command (for Internal and External Data Memory) is used to write a block of memory to a disk 
file. The block will be written in the same format that the data is displayed on screen. When you select the 
Write command, a Dialog Box will prompt you for the address range of the block to write and for the name 
of the file to write the data to. 



Display/Alter\Code | Write 



The Write command (for Code Memory) 
calls a Pull-down Menu from which you 
may write code memory to a disk file in a 
Dump format, a reloadable Hex format 
and a reloadable S-Record format. 

The commands are: 



ii 



i sp 1 ay /A 1 te r 



Misc Source/Symbols Break/Trace 



Asro/Dasm Shift-F4 MR? :88 C?:B AC:B FB:8 OU:B 

Memory ||b IE 48 IOCOM - ■ BB II 

SS^^KHS^KSP PCON 18 PSU 88 RC 

Uieu/Change Code flenory =n 

B rouse Fill Houe Compare TStTTI |J 



Address 8B8B 



8B8B 82 88 FD BB 88 88 BB 8B 




Display/Alter\Code \ Write \ Dump 

The Dump command is used to to write a block of code memory to a disk file. The block 
will be written in the same format that the data is displayed on screen. When you select 
the Dump command, a Dialog Box will prompt you for the address range of the block to 
write and for the name of the file to write the data to. 



Display /Alter \ Code \ Write \ Hex 

The Hex command is used to write code memory to a reloadable disk file in Intel 
Standard Hex format (see Appendix F, File Formats). When you select the Hex com- 
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Display/Alter | Code \ Write \ S-Record 



The S-Record command is used to write code memory to a reloadable disk file in 
Motorola S-Record format (see Appendix F, File Formats). When you select the 
S-Record command, a Dialog Box will prompt you for the address range of the block to 
write and for the name of the file to write the data to. 



Display/Alter \ Var/Reg 



— 







The Var/Reg command can be used to change the value of any program variable (including bits) or register 
(including the PC). When you select this command you will be prompted for the name of the variable or 
register to change and for its new value. The current value will also be displayed. 

Display/Alter \ Ram-Bits 



i splay /t\ Iter 



Misc Source/Synbo 1 s Break/ Trace 



The RAM-Bits command is used to view 
or change bits in the 128 directly-ad- 
dressable bit area of Internal Data mem- 
ory. A bit's value may be toggled by 
typing the bit address (absolute or sym- 
bolic) or by using the cursor keys to 
move to the desired bit and then press- 
ing the Enter key. Note that SFR bits 
can be changed using the Var/Reg com- 
mand (above) or using Change Mode for 
the Register Window. 



Asn/Dasn Shift-F4 ► R7:88 C¥:B ftC:B FB:0 0V:8 



-Memory- 



Code Alt-FZ ► 
Idata Alt-F3 ► 
Xdata Alt-F4 ► 

; RAM Bit Memory 

Address J^Bj 



8 IE- - 

F PCON 

4 T2C0N 88 ICON 88 

8 TL2 88 TMOD 88 



48 IOCON- 88 IP 
18 PSU 88 RC 
IH 




Address 



High 
Nibble 



Address Lou Nibble 





8 


l 


2 3 4 5 6 7 8 


9 A 


B 


C 


D 


E 


F 


8 


8 


8 


8 8 8 8 8 8 








a 


8 











8 


1 


8 


8 


8 8 8 8 8 8 


8 





a 














a 


2 


8 


8 


8 8 8 8 8 8 


8 





8 


8 








8 


a 


3 


a 





8 8 8 8 8 8 


8 




















a 


4 


a 





8 8 B 1 8 8 








8 


8 











a 


5 


8 


8 


8 8 8 8 8 8 











8 








8 


a 


6 


8 


8 


8 8 8 8 8 8 











8 











8 


7 


e 


8 


8 8 8 8 8 8 














8 








8 








Ctrl-V:Move 
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Source/Symbols Break/Trac 



:HH Usage 



PROM Programmer ► 

A-to— D Conuerter 
Multiply-Diuide Unit 
DPTRs (multiple) 
FIFO 

Performance Analyzer— 

High Resolution Alt-F9 
High Bin Count Alt-FIB ► 



If your Host Computer has LIM-compatible expanded memory, the iceMASTER Host Software can 
make limited use of it. To enable access to expanded memory, you must have the appropriate "Device = " 
statement in your CONFIG.SYS file. See the documentation provided by the manufacturer of your 
expanded memory for specific details. 

The EMM Usage command displays the following information: 
System 
Other 



Usable 
In Use 



Misc | PROM Programmer 



The PROM Programmer command is used to operate a special piece of hardware with which you may 
program 83C751 or 83C752 PROM's and EPROM's. For those who buy the special hardware, a write-up 
describing the use of the PROM Programmer command is available. 

Misc \A to D Converter 



The A to D Converter command is used to read all analog to digital converter channels and display each 
channel's digital value in hexadecimal. 

Note: The reading of the analog to digital converter requires that certain registers be set in the proper 
state to activate this function. Executing the^4 to D Converter command will modify those registers. Refer 
to the data specification for the microcontroller in use to determine which registers may be affected. 
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The Misc command calls a Pull-down Menu from which you 
have access to: 

1) unique features of the microcontroller 

2) special options/features of the iceMASTER emulator 



Misc\EMM Usage 



The total amount of expanded memory 
present in your Host Computer. 

The amount of expanded memory being 
used by programs other than the 
iceMASTER Host Software. 

The amount of expanded memory which 
can be used by the Host Software. 

The amount of expanded memory actually 
being used by the Host Software. The In 
Use value will never exceed the value for 
Usable. 



Misc\Multiply-Divide Unit 



The Multiply-Divide Unit command is used to display the formatted result of an arithmetic operation of 
the 80C517 and 80C537 Multiply-Divide Unit (MDU). Pressing the Enter key toggles the interpretation 
of the result between signed decimal and unsigned decimal format. The result is displayed in a format for 
each type of operation possible for the MDU. 

Misc\DPTRs (multiple) 



For all microcontrollers that have more than one data pointer, the DPTRs (multiple) command is used to 
display values for all DPTRs (data pointers) in hexadecimal. The values for the selector register are also 
displayed in hexadecimal. 

Misc\FIFO 



The FIFO command is used to read and display values from the FIFO feature of your microcontroller (if 
present). The values are displayed in hexadecimal. Note that once the FIFO is read the data in the FIFO 
is lost as the read is destructive and the data cannot be restored. 

Misc\High Resolution (Mode! 400 emulators only) 
Misc\High Bin Count (Model 400 emulators only) 



Performance Analyzer Overview 

» : , , : : 

The performance analyzer allows you to monitor the amount of time spent executing specified parts of 
the program loaded in code memory. There are several reasons for using a performance analyzer: 

1) To identify and optimize program "hot spots". 

2) To verify there is no "dead" (unexecuted) code. 

3) To verify that execution is always within program bounds. 

4) To verify execution of certain code in response to some internal or external condition/stimulus. 

There are two types of performance analysis available, a High Resolution Performance Analysis and a 
High Bin Count Performance Analysis. The High Resolution Performance Analysis has 15 bins available 
but is very accurate (the PC is sampled approximately every 5.4 microseconds). The High Bin Count 
Performance Analysis has 999 bins available but the PC is sampled mush less often. 

Each portion of the program to be monitored is called a bin. Usually, each bin will consist of a single code 
memory address range (starting address through ending address, inclusive), although a bin may be created 
with several code memory address ranges which are not contiguous. PC sample counts and percentages 
are collected on a per-bin basis. 

Bin Layout 



A bin contains a "type, a Number, a Capture Range and a Description, as follows: 
Bin Types Miss Bin 
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The Miss Bin is automatically added to a setup if the defined Capture Ranges do not entirely cover code 
memory (i.e., if there are gaps in the address ranges to be monitored). This may occur after a bin has been 
Edited or Added, after a Quick-setup has been defined, or after a setup has been Loaded. 

The Miss Bin is assigned to Bin Number 15 for the High Resolution Performance Analyzer setup and to 
Bin Number 999 for the High Bin Count Performance Analyzer setup. You cannot modify the Miss Bin. 

Break Bin 

The Break Bin is available only for the High Resolution Performance Analyzer setup since the normal 
break-point mechanism is inoperable when performing a High Resolution Performance Analyzer setup. 
The Break Bin is always Bin Number 16. You can specify any number of break-points (or ranges) using 
the Break Bin. This bin may be created by Adding a bin and setting the bin number to 16, or by Editing 
an existing bin and changing its bin number to 16. 

During High Resolution Performance Analyzer emulation if the program executes at any code location 
monitored by the Break Bin, emulation will break (stop) as with 'normal' break-points. 

User Bin 

The User Bin is any bin that you have Added or Edited, other than the Break Bin. If a bin created by a 
Quick-setup is later Edited its Bin Type will be changed to User. 

Neql Bin 

The Neql Bin is a bin that was created using the Quick-setup \N-Equal command (page 7-46). 
Mod Bin 

The Mod Bin is a bin that was created using the Quick-setup {Module command (page 7-46). 
Proc Bin 

The Proc Bin is a bin that was created using the Quick-setup \ Procedure command (page 7-46). 
Lnum Bin 

The Lnum Bin is a bin that was created using the Quick-setup \Line Numbers command (page 7-47). 

Bin Number The Bin Number can be any number greater than and less than or equal to the maximum number of bins. 

The maximum number of bins allowed is normally 15 for the High Resolution Performance Analyzer setup 
and 999 for the High Bin Count Performance Analyzer setup. If the current setup requires a Miss Bin, the 
maximum number of bins allowed is 14 for a High Resolution Performance Analyzer setup and 998 for a 
High Bin Count Performance Analyzer setup as the miss bin number is 15 for the High Resolution 
Performance Analyzer setup and 999 for the High Bin Count Performance Analyzer setup. 

In the case of a High Resoludon Performance Analyzer setup, setting the bin number to 16 is legal and 
causes a Break Bin to be created. 

Bin Capture The Capture Range is the range of code addresses monitored by a bin (for which sample counts are 
Range captured). All Capture Ranges (for all bins) will always be within the bounds of the Capture Span. In 

addition, no Capture Range will ever overlap any other Capture Ranges. Note that there may be several 
distinct Capture Ranges for the same bin number depending on how the setup was created. 

When Editing a bins Capture Range several checks are made to determine if the range is valid. The ending 
address of the range must be equal to or greater than the starting address range and the range may not 
overlap any other range, except for any ranges in Miss Bins. 
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Bin The Bin Description field allows you to enter a descriptive tag for a bin. Up to 30 characters can be 

Description displayed. The Bin Description field is also used by the Quick-setup commands to tell you how each bin 
was created. 

The window called by the Misc \High Resolution command and the Misc \High Bin Count command is 
normally called the Performance Analyzer Setup Window. Although the Performance Analyzer Emula- 
tion Window (where the actual analysis is viewed) is called from this window (Misc \High Resolution \Run 
Pull-down and Misc \High Bin Count \Run Pull-down), it will be described in a section by itself, after the 
following description of the Performance Analyzer Setup Window. 



Performance Analyzer Setup Window 



Configure File Run Display/Alter Misc Source/Symbols Break/Trace Help 
H igh Resolution Performance Analysis Setu p 
Statistics Run jlHMlgcj^4IB Misc Edit Add Delete File 



Program Span: 8888-0188 Accumulate Stats: Off 

Capture Span: 8888-8188 

Setup - Capture Range Order- 
Type Bin Range Description 



Miss 
Mod 
Mod 
Mod 

Miss 



15 B888-B89F 

1 88A8-88B6 F_HLMAIN 

2 B8B7-B8EB F_IHMER 

3 88EC-B8FC F_UASTE 
15 B8FD-FFFF 



Ctrl-R:Resize Ctrl-U:Moue 



Q uick Performanc e Analyzer setup s 
s lEff 



Bins: 



ymAlpli 
tepTo 



The following commands are available from the Performance Analyzer Setup Window: 



Misc I High Resolution [Statistics 
Misc | High Bin Count { Statistics 



The Statistics command calls a Pull-down Menu from which you may Accumulate, Clear and View 
performance analyzer statistics (sample counts). 



Misc I High Resolution [Statistics { Clear 
Misc | High Bin Count \ Statistics { Clear 



The Clear command clears any statistics (sample counts) gathered during previous 
performance analyzer emulation(s). 



Misc {High Resolution {Statistics \ Accumulate 
Misc | High Bin Count\Statistics {Accumulate 



The Accumulate command allows you to control whether or not statistics (sample 
counts) from one performance analyzer emulation to the next will be accumulated. 
When accumulate is OFF any statistics from previous emulations are cleared before 
subsequent emulations. When accumulate is ON any statistics from new emulations are 
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added to the statistics from previous emulations. The state of the accumulate command 
is displayed next to the command in the Pull-down Menu and in the Performance 
Analyzer Setup Window just below the Menu Bar. 



Misc 
Misc 



High Resolution [Statistics I View 
High Bin Count\Statistics \ view 

The View command allows you to view the results of previous performance analyzer 
emulations. See the description of the Performance Analyzer Emulation Window for 
more information (page 7-49). 



Misc I High Resolution [Run 
Misc | High Bin Count | Run 

The Run command calls a Pull-down Menu from which you may start a performance analyzer emulation. 
Note that a performance analyzer setup must be defined before any of these commands will function. 



High Resolution [Run [Reset (emulator) 
High Bin Count\Run\Reset (emulator) 

The Reset (emulator) command starts a performance analyzer emulation from a Reset 
condition. The Reset signal will be supplied by the emulator itself. See the description 
of the Performance Analyzer Emulation Window for more information (page 7-49). 

Misc I High Resolution J Run I Reset (target) 
Misc | High Bin Count] Run [Reset (target) 



Misc 
Misc 



The Reset (target) command starts a performance analyzer emulation from a Reset 
condition. The Reset signal will be supplied by the target system. Emulation will not 
begin until a Reset signal is received from the target system. See the description of the 
Performance Analyzer Emulation Window for more information (page 7-49). 

Misc I High Resolution [Run \ Go 
Misc | High Bin Count \ Run \ Go 

The Go command starts a performance analyzer emulation. Emulation begins at the 
code memory location indicated by the PC. See the description of the Performance 
Analyzer Emulation Window for more information (page 7-49). 

Misc I High Resolution \ Quick-setup 
Misc | High Bin Count\Quick-setup 

The Quick-setup command calls a Pull-down Menu from which you may to quickly define one of four types 
of automatic performance analyzer setups. They are N-Equal, Module, Procedure and Line Numbers. 
The number of Bins used for a quick-setup can also be set, otherwise the default number of bins will be 
used. No bins will be created with Capture Ranges out of the Capture Span used for the setup. 
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i»iioo |< uyii am ouum | WU/CTK-seO/p \BinS 

The Bins command allows you to specify the number of bins to use in a Quick-setup. 
However, if there are not enough ranges (generated by the quick setup) to fill the 
number of bins specified the number of bins will be be set to the number needed. For 
example, if you specify 12 bins and then select a Module quick setup and there are only 
4 modules, the number of bins will be set to 4. 

In addition, if the number of bins is not defined before a quick setup is selected, the 
number of bins will default to 15 for a High Resolution Performance Analyzer setup and 
50 for a High Bin Count Performance Analyzer setup. Of course, this number may be 
automatically adjusted downward as described above. The maximum number of bins 
that may be specified is 15 for a High Resolution Performance Analyzer setup and 999 
for a High Bin Count Performance Analyzer setup. The number of bins is displayed in 
the Quick-Setup Pull-down Menu and at the upper right in the Performance Analyzer 
Setup Window. 

If the maximum number of bins is specified there is a special case where the number of 
bins may be decremented by one. This will happen if a Miss Bin is needed. 



Misc I High Resolution | Quick-setup [N-Equal 
Misc I High Bin Count | Quick-setup \ N_Equal 



The N-Equal command is used to quickly define a setup of equally sized bins. It does 
this by partitioning the Capture Span into N equally sized areas (where N is the number 
of Bins). Each created bin will be created as Type 'Neql' with the Description set with 
the number of bytes in the Capture Range. 



Misc I High Resolution \ Quick-setup [Module 
Misc | High Bin Count\Quick-setup \ Module 



Misc 
Misc 



The Module command is used to quickly define a setup monitoring module address 
ranges. If possible, each bin will monitor one module; as specified by the program 
currently loaded into code memory. If the program contains more modules than the 
number of Bins, each bin may monitor several modules. 

Each created bin will be created as Type 'Mod' with the Description set with the name(s) 
of the module(s) monitored by the bin. Each bins Capture Range will be from the 
starting address of the first module monitored by the bin through the ending address of 
the last module monitored by the bin, inclusive. 

High Resolution \ Quick-setup [Procedure 
High Bin Count \ Quick-setup | Procedure 



The Procedure command is used to quickly define a setup to monitor the address ranges 
between procedures, functions and global (public) code labels. If possible, each bin will 
monitor the range between one procedure, function, or global code label and the next. 
If the program contains more procedures, functions, and global code labels than the 
number of Bins, each bin may monitor the address range encompassing several proce- 
dures, functions, or global code labels. 
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Each created bin will be created as Type 'Proc' with the Description set with the name(s) 
of the procedure(s), function(s), or global code label(s) monitored by the bin. Each bins 
Capture Range will be from the address of the first procedure, function, or global code 
label monitored by the bin through the address (-1) of the first procedure, function, or 
global code label monitored by the next bin. 

Note that global code memory labels are included because not all language processors 
(compilers) mark procedures/functions properly in the absolute object module debug 
records. 

Misc I High Resolution \ Quick-setup [Line Numbers 
Misc | High Bin Count \ Quick-setup \ Line Numbers 

The Line Numbers command is used to quickly define a setup monitoring line number 
address ranges. If possible, each bin will monitor the range between one line number 
and the next line number. If the program contains more line numbers than the number 
of Bins, each bin may monitor the address ranges encompassing several line numbers. 

Each created bin will be created as Type 'Lnum' with the Description set with the 
name(s) of the module(s) and line number(s) monitored by the bin. Each bins Capture 
Range will be from the address of the first line number monitored by the bin through the 
address (-1) of the first line number of the next bin. 

Misc I High Resolution [Misc 
Misc I High Bin Count \ Misc 

The Misc command calls a Pull-down Menu from which you may Clear a defined performance analyzer 
setup, change the Sort Order used to display a performance analyzer setup and to define the Capture Span 
the performance analyzer setup will encompass. 

Misc I High Resolution [Misc \ Clear 
Misc I High Bin Count \ Misc \ Clear 

The Clear command is used to clear all bins associated with a defined performance 
analyzer setup. This includes any statistics from previous performance analyzer emula- 
tions. 

Misc\High Resolution [Misc [Sort Order 
Misc I High Bin Count \ Misc \ Sort Order 

The Sort Order command is used to change the sort order of the displayed bins in the 
current performance analyzer setup. The setup can be sorted by either Bin Number or 
Capture Range. The current sort order is displayed in the Pull-down Menu and in the 
title above the bins in the performance analyzer setup window. 

Misc I High Resolution [Misc \ Capture Span 
Misc | High Bin Count \ Misc | Capture Span 

The Capture Span command allows you to specify the code memory address span over 
which the bin Capture Ranges may be defined. Neither Quick-setup bins or user-defined 
bins can have a capture range out of that span. The capture span is displayed in the 
upper left of the performance analyzer setup menu. 
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If a quick setup is selected before the capture span has been defined, the capture span 
will default to the address range covered by the program currently loaded in code 
memory. If no program is loaded the capture span will then default to all of addressable 
code memory. 

Misc I High Resolution [Edit 
Misc \ High Bin Count [Edit 

The Edit command allows you to edit the contents of the currently highlighted bin. Any bin can be edited 
except for the Miss Bin. All fields of a bin (Number, Capture Range and Description) can be edited except 
for bin Type which is changed automatically by the software depending on how the other fields are edited. 
In general, the bin type will be changed to 'User' if any fields of the bin are changed. 

If the edited fields are valid the Miss Bins will be recalculated and the setup will be sorted and redisplayed. 

Note that if the Edit command is selected when no bins are defined you are given an empty bin to edit, 
which is effectively the Add command (below). 

Misc I High Resolution \Add 
Misc\High Bin Count\Add 

The Add command allows you to add a bin to the current performance analyzer setup. When the Add 
command is selected control is automatically passed to the Edit screen with an empty bin and edit screen 
rules apply. If the edited fields are valid the bin will be added to the setup, the Miss Bins will be 
recalculated, the number of Bins will be incremented by one and the setup will be sorted and redisplayed. 

Misc I High Resolution \ Delete 
Misc \ High Bin Count {Delete 

The Delete command is used to delete the currently highlighted bin from the current performance 
analyzer setup. Any bin but the Miss Bin can be deleted. After a bin has been deleted the miss bins will 
be recalculated, the number of Bins will be decremented by one and the setup will be sorted and 
redisplayed. 

Misc I High Resolution [File 
Misc | High Bin Count \ File 

The File command calls a Pull-down Menu from which you may save a performance analyzer setup to a 
disk file and to load a previously saved performance analyzer setup from a disk file. 

Misc High Resolution [File [Save 
Misc High Bin Count\File\Save 

The Save command allows you to save the currently defined performance analyzer setup 
to a disk file. You will be prompted for the name of the file. A saved setup can be restored 
later using the Load command (below). 

MisclHigh Resolution [File [Load 
Misc | High Bin Count \ File \ Load 



The Load command allows you to restore a previously stored performance analyzer 
setup (via the Save command above). You will be prompted for the name of the file. 
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Performance Analyzer Emulation Window 



Configure File Run D isp lay/A 1 tar Misc Source/Symho Is Break/Trace Help 
High Resolution Performance Analyzer 
ITT'. Symbol lc HLL Mixed Counts Expand Hisses Writ© Help 
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Bins: 16 Tine:| 
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1.5* 1.5 
36.8* 38.3 
61.7*180.8 

8.8*100.0 




1 Esc : Break Emulation 

Display Node: bar graph lines only (one per bin) 

The Performance Analyzer Emulation Window is called when a performance analyzer emulation is 
started by the following commands: 

Misc \High Resolution \ Run \ Reset (emulator) 
Misc \High Resolution \Run \Reset (target) 
Misc \High Resolution \Run \ Go 
Misc \High Bin Count \ Run \ Reset (emulator) 
Misc \High Bin Count \Run \ Reset (target) 
Misc \High Bin Count] Run | Go 

or when a post-emulation review of statistics is called by the following commands: 

Misc {High Resolution [Statistics | View 
Misc \High Bin Count [Statistics \ View 

This window shows the predefined bins along with a periodically updated display. The data (sample 
counts) is updated approximately once every two seconds during an emulation. From this window you can: 

Display bin statistics only (Raw) 

Display all labels and bin statistics (Symbolic) 

Display HLL source images/lines and bin statistics (HLL) 

Display all labels, HLL source images/lines and bin statistics (Mixed) 

Toggle bin statistics display between bar graph lines and actual bin sample counts (Counts) 

Toggle to/from additional information for each range in each bin (Expand) 

Toggle to/from accumulating Miss Bin Count in total sample count and percentages (Misses) 

Write performance analysis information to a file (Write) 
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Performance Analyzer Status Information 



The top delimiter line of Performance Analyzer Emulation Window displays the type of performance 
analysis currently being viewed. Several status parameters are displayed in the two lines directly below the 
top delimiter line. They are described as follows: 

Counts Indicates if the bin statistics are displayed as actual sample counts (ON) or as a percentage bar graph 

(OFF). See the Counts command (below) for more information. 

Expand Displays the current Expand mode setting (ON/OFF). See the Expand command (below) for more 

information. 

Misses Indicates if Misses are being added in the statistics. See the Misses command (below) for more informa- 

tion. 

Resets Displays the number of resets that occurred in the current emulation cycle. 

PC Displays the hexadecimal address of the next instruction which will be executed. 

Brk Addr Displays the hexadecimal address at which emulation was stopped (post-emulation review only). 

Bins Displays the number of bins defined in the current setup. 

Time Displays the execution time of the current emulation cycle. 

Samples Displays the total sample count. 

Display Mode The current display mode is shown below the Counts status. See the Raw, Symbolic, HLL and Mixed 
commands (below) for more information. 

Performance Analyzer Emulation Window Commands 

Note that there are 8 possible paths to each of the following commands (see page 7-49), therefore, only 
the command will be listed and not the full command sequence. 

Raw 

When the i?aiv command is selected, only bin statistics are displayed (one count or bar graph line per bin) . 
Symbolic 

When the Symbolic command is selected, one statistic line (count or bar graph) for each bin is displayed, 
followed by one line for each global (public) and/or local code memory label within each address range 
in that bin. Model file directive A42 (see Appendix M, Model File Configuration) controls whether only 
global code labels or only local code labels, or both, are displayed. In the display, global code labels are 
preceded by an asterisk to distinguish them from local code labels. 

HLL 

When the HLL (High Level Language) command is selected, one statistic line (count or bar graph) for 
each bin is displayed, followed by the HLL source line images within each address range in that bin. If a 
particular HLL source image is not available to the emulator only the module name and line number will 
be displayed. If the program loaded into code memory does not contain source line number debug 
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records, it is not possible for the emulator to display either HLL source line images or module names and 
line numbers. 

Mixed 

When the Mixed command is selected, one statistic line (count or bar graph) for each bin is displayed, 
followed by code labels and HLL source images. If a code memory label and an HLL source image are 
located at the same code memory address, the code memory label will appear in the display before the 
HLL source image. 

Counts 

When the Counts command is selected, it toggles the bin statistics display from showing a bar graph 
(percentage) line for each bin to showing the actual sample (hit) count for that bin. The Counts display 
command is independent of any other display control command. The sum of the sample counts for each 
bin usually equals the total sample count shown at the top-right of the display at Samples, however, the 
Miss Bin may or may not be included in the total Samples count. See the Misses command below for more 
details. 

Note that an asterisk following the percentage of time spent in a bin indicates a non-zero sample count 
for that bin. This indication is useful, as the percentage of time spent in a particular bin may be non-zero, 
but less than 0.1% (in which case, the percentage of time spent in that bin is displayed as 0.0*). 

Expand 

When the Expand command is selected, it toggles the display into and out of expanded display mode. The 
Expand command is independent of any other display control command. When expanded mode is ON, 
following each statistic line for each bin, there will be one line showing each address range in the bin if: 

1) that bin is a named bin (has a name), or 

2) that bin contains more than one address range 

The expanded display mode can be entered only if there is at least one bin that satisfies one of these 
conditions. 

Misses 

The Misses command, a toggle, controls whether or not "misses" are included in the total sample count 
displayed at the top-right of the screen at Samples and in the cumulative percentage statistic. 

The performance analyzer allocates the Miss Bin to monitor program execution in code memory locations 
not being explicitly monitored by the user. The Miss Bin does not exist if the user is explicitly monitoring 
every code memory location. Even when the Misses Command is toggled to the OFF position (and thus, 
the percentage for the Miss Bin is computed as zero), the actual sample counts in the Miss Bin may be 
viewed by toggling Counts to ON, using the Counts command above. 
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Source/Symbols 



When the Source/Symbols command is selected a Pull- 
down Menu of options relating to High Level Language 
and Symbol display and search is displayed. 



Source/Symbols\Module Update 



The Module Update command is used to select the Module 
Update Mode. This mode determines how the software 
will decide what the Current Module (see Source/Sym- 
bols | Current Module below) is. The mode choices are Auto 
(automatic) and User (user-defined). 



Source/Symbols \ Module Update \Auto 

The Auto Module Update Mode means that the software will automatically determine what the Current 
Module is. This determination is made based on the PC address. If the PC address falls within the address 
range of a module, that module will be made the Current Module. 

Source/Symbols \ Module Update \ User 

The User Module Update Mode means that you have set (or will set) the Current Module to a specific 
module which will remain the Current Module until the Module Update Mode is changed to Auto or until 
you change the Current Module. 

Source/Symbols \ Current Module 

The Current Module command is used to set the Current Module to a specific module. When a Current 
Module has been set this way the Module Update Mode is set to User. 

The concept of the Current Module is to make Symbolic searches context sensitive. If there are two 
symbols with the same name (that were defined in two different modules) the Current Module will be 
searched first. 

Source/Symbols {Source Path 



The Source Path command is used to set the HLL (High Level Language) search path directory used to 
locate the source or listing files for each module in the program currently loaded into code memory. The 
source files (C) or listing files (PL/M) must exist in the HLL search path to enable the emulation system 
to locate and display HLL source images. 

The HLL search path may also be set using the '-s' command line option (Appendix J). 
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Source/Symbols \ Raw Source 



Module 
Line S 



Source Code- 
Language : C 



File : f_hlnain.c 



Line 8 Raw Source Code 
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/* File: f_hlmain.c */ 

/* C Language Demo Program 'F_DEMO.AOM' (AOM == Absolute Object Modu 

*» for use with the Frank 1 in/He i ] 8851 C Cross-compiler. 
** Version 2.12 or later. 

** Uersions actually used here: Compiler: U3.86 (Professional E 

«*• Assembler: Y4.4 

Ctrl-R:Resize CtrI-V:Move Tab.Shift-Iab:Select = 



The Raw Source command displays the raw source fde for a specified module. Each source line image is 
preceded by its line number. The line numbers that are highlighted specially correspond to line numbers 
with entries in that module's line number table, meaning they may be referenced symbolically throughout 
the software (e.g., in setting breakpoints). 

File information, such as the source language and source filename are displayed along with the name of 
the module. The module being displayed can be changed by typing a new module name at the Enter 
Module prompt. 

The displayed source images can be positioned quickly to a particular line number by typing the desired 
line number at the Line Number prompt. 



Source/Symbols {Modules 



■♦lodule 



Enter Module 



Address 
Range 



Module Name 



Language 



8880-8888 FJJECT 
BBA8-88B6 F_HLMAIN 
8BB7-88EB F_IHNER 
8BEC-88FC FJJASTE 



C 
C 
C 



Source File 



f _hlmain .c 
f _inner .c 
f waste . c 



Ctrl-R: Resize Ctrl-U:Moue 



The Modules command displays module information for all modules. The information is displayed sorted 
by module address range. 

The Enter Module prompt is used for a special type of symbolic search. If the entered string is found to 
be one of the module names the display is scrolled so that name is displayed. In addition, a full name does 
not have to be entered for the search to work. If only a partial name is entered the first name found that 
starts with the entered string will be selected. 

Two screen modes are available for this command. The narrow screen contains just the module address 
range and name of each displayed module. The wide screen contains (in addition to the address range 
and name) the Source File and Language for each module. The Ctrl-R command is used to toggle between 
the screen modes. 
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■S copes - 

Enter Mod / Proc 



Address Module / Procedure Nane 
Range (Number = Scope Level) Language Source Pile 



8080-0008 1 F_VECT 

8BA8-88B6 1 F_HLMAIN C f_hlnain.c 
2 MAIN 

8BB7-08EB i F_INNER C f_inner.c 
2 _INNERLOOP 

8BEC-00FC 1 F_WASTE C f .waste. c 

2 WASTE TIME 

Ctrl-R: Resize Ctrl-U:Mo«e 



The Scopes command displays scope information for all modules and procedures. The information is 
displayed sorted first by module address range and then alphabetically by procedure name within each 
module. 

The Enter Module/Procedure prompt is used for a special type of symbolic search. If the entered string 
is found to be one of the module, or procedure names the display is scrolled so that name is displayed. In 
addition, a full name does not have to be entered for the search to work. If only a partial name is entered 
the first name found that starts with the entered string will be selected. 

Two screen modes are available for this command. The narrow screen contains just the module address 
range and name of each displayed module. The wide screen contains (in addition to the address range 
and name) the Source File and Language for each module. The Ctrl-R command is used to toggle between 
the screen modes. In addition, Procedure names and their Scope Levels are listed for each module. 

Source/Symbols \ Line Numbers 











Enter Module | 








Address Module Nane 




Symbol Name | 


Range 


Line It Addr 


HLL Source Image / 




8000-0000 F UECT 
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8BA8-B8B6 F HLMAIN 










33 8BA8 


state = e; 
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8BA8 


MAIN 






35 80A3 


for ( counter =8; 


counter** ) { 




36 88A5 


Pl_8 = 8; 


/* Set PI. 8 lou I 




37 8BA? 


inner loop ( 18 ); 


/« Generate 5 p I 









The Line Numbers command displays line number information for all modules. The information is 
displayed sorted first by module address range and then by ascending line numbers within each module. 

The Enter Module prompt is used for a special type of symbolic search. If the entered string is found to 
be one of the module names the display is scrolled so that name is displayed. In addition, a full name does 
not have to be entered for the search to work. If only a partial name is entered the first name found that 
starts with the entered string will be selected. 

Two screen modes are available for line number information for this command. The narrow screen 
contains the Line Number, its Address and the names of any Symbols defined at that address. The wide 
screen contains (in addition to the line number, address and symbol name) the Source Image for the line 
number. For lines describing modules, the information displayed for each module is the address range 
and name. 
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Source/Symbols | Global 
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unknown 




BIT 


88C9 


+ CNT2 




B 
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The Global command displays all global (public) symbols associated with the program currently loaded 
in code memory. Symbols are listed sorted alphabetically. See Symbol Window Information below. 

Source/Symbols \ Local 
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The Local command displays all local symbols associated with the program currently loaded in code 
memory. Symbols are listed sorted first by module (or procedure) and then alphabetically within each 
module. See Symbol Window Information below. 

Source/Symbols | Alpha 
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The Alpha command displays all local and global (public) symbols associated with the program currently 
loaded in code memory. Symbols are listed sorted alphabetically. See Symbol Window Information below. 



7-55 



Source/Symbols | Address 



Enter Symbol_ 
Code Xdata 



■All Symbols - By Address- 



Indirect Bit Munber 
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The Address command displays all local and global (public) symbols associated with the program 
currently loaded in code memory. Symbols are listed sorted first by memory space and then by address 
within each memory space. The *■ and -* keys select the desired memory space and scroll the display to 
the first symbol in that memory space. If no symbols exist in a particular memory space the «- and -» keys 
will skip that memory space. See Symbol Window Information below. 

Symbol Window Information 



Two screen modes are available for these commands. The narrow screen contains just the memory space, 
address, and name of each displayed symbol. The wide screen contains (in addition to memory space, 
address, and name) value, data type and scope information for each symbol. The Ctrl-R command is used 
to toggle between the screen modes. 

If the symbol name is preceded by a plus sign that symbol was read from the $MODEL file during 
iceMASTER initialization. If the symbol name is preceded by an asterisk that symbol is defined as a global 
(public) symbol. Note that all symbols read from the SMODEL file are treated as global (public) symbols. 

The value of a symbol can be displayed in hexadecimal, decimal, or ASCII. If the data type of the symbol 
is known, the display format selected is defined by Model File Directive A50, which you can modify (see 
Appendix M, Model File Configuration). The default display format selections are hexadecimal for char, 
unsigned char and float, and decimal for int, unsigned int, long and unsigned long. If the data type of a 
symbol is unknown the symbol value is displayed in hexadecimal. The number of bytes displayed for an 
unknown data type is by default 1 but can be changed using the Configure \ Options \ Unknown data type 
size command (page 7-22). 

The scope information displayed for a symbol is dependent on the type of symbol it is. In general, the name 
of the module or procedure that the symbol was defined in will be displayed along with scope/nesting level 
information. 
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Break/Trace 



The Break/Trace command calls a Pull-down Menu which 
gives you direct access the the break-point and tracing features 
of the emulator. 



Break/Trace \Set 



The Set command calls the Break Menu Window from which 
you may add, remove, edit or just view breaks (both Simple 
and Complex). If breaks are added or edited in the Break 
Menu, they are evaluated and set only upon exit from the 
Break Menu. 



/Symbols 



reak/Trace 



Help 
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Shift-F2 
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Clear 
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End 
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Shift-F3 







The Break Menu also provides access to the Opcode Class Menu Window. 
The Break Menu is divided into two windows: 



Configure File Run Display/Alter Misc Source/Symbo Is Break/Trace Help 

Break-Points & Trace-On/Of f 

Remove Edit Hex Symbolic Opcode_Class Load Saue 

-Simple 




A dd a br eak element 
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Ctrl-H:Resize Ctrl-W:Mo«e Tab, Shift-Tab : Select = 



ieuTrc 
esetTg 



itfinjiFTill ^SS3S 'I 
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tepL inSjStepOur slStepTo 



Simple Break Window 

Simple Breaks are single addresses or address ranges where break-points are set or where trace is turned 
ON or OFF. A Code Break-Point, a Trace-On-Point (Model 400 emulators only) or a Trace-Off-Point 
(Model 400 emulators only) may be set for any code memory address (or range). An External Data 
Break-Point may be set for any External Data address (or range). 

Use the Tab key to toggle between the Simple Break Window and the Complex Break Window. 
Complex Break Window 

Complex Breaks can be Code Break-Points, Trace-On-Points (Model 400 emulators only) and Trace-Off- 
Points (Model 400 emulators only). Each Complex Break element (one per line) is evaluated as the AND 
condition of a Code Address (or range), a Direct Address (or range), a Bit Address (or range), an Opcode 
Value (or range of values), an Immediate Operand Value (or range of values) and an Opcode Class. If any 
of the fields are left blank they are not ANDed during the evaluation. 



7-57 



Obviously, it is easy to create a Complex Break element that makes no sense (sets no breaks) . For example, 
if an opcode value of 80h (SJMP) is selected along with any direct address this element will evaluate to 
NULL (no breaks). When the Complex Breaks are evaluated, NULL elements are considered errors and 
you will be notified of that by an error message. The Complex Break element(s) that evaluate to NULL 
will be marked in the Complex Break Window by replacing the break type (see CBREAK, TRON and 
TROFF under Break/Trace \ Set \ Add below) with the type NULL. The type will remain NULL until 
Complex Break elements are re-evaluated. 

Use the Tab key to toggle between the Complex Break Window and the Simple Break Window. When the 
Symbolic Mode (see Break/Trace] Set \ Symbolic on page 7-60) is active the Ctrl-*- and Ctrl— » keys are 
used to scroll the displayed Complex Break fields (all fields cannot fit on the screen at one time). 

Break/Trace \ Set \ Add 



When the Add command is selected a Pull-down Menu 
is called from which the type of break to add may be set. 
Code Break-Points, Trace-On-points (Model 400 emu- 
lators only) and Trace-Off-Points (Model 400 emula- 
tors only) may be set for both Simple and Complex 
Break Windows. External Data Break-Points may be 
set in only the Simple Break Window. 

Break/Trace \Set\ Add \ CBREAK: Code Break-Point 

When the CBREAK: Code Break-Point command is selected the type of break element 
to be added is set to a Code Break-Point. Control is then immediately passed to the 
Break/Trace \ Set \ Edit command (below). 

Break/Trace \Set\ Add \XBREAK: External Data Break-Point 

When the XBREAK: External Data Break-Point command is selected the type of break 
element to be added is set to an External Data Break-Point. Control is then immediately 
passed to the Break/Trace] Set | Edit command (below). This command is available only 
for the Simple Break window. 

Break/Trace \ Set \ Add \ TRON: Trace-On-Point 

This command is available on Model 400 emulators only. When the Trace-On-Point 
(TRON) command is selected the type of break element to be added is set to a 
Trace-On-Point. Control is then immediately passed to the Break/Trace \Set\Edit com- 
mand (below). Note that executing through a Trace-On-Point causes the Trace Trigger 
Output signal to strobe low (see Probe Clip Assembly on page 3-6). 

Break/Trace \ Set [Add | TROFF: Trace-Off-Point 

This command is available on Model 400 emulators only. When the TROFF: Trace-Off- 
Point command is selected the type of break element to be added is set to a Trace-Off- 
Point. Control is then immediately passed to the Break/Trace \Set\Edit command 
(below). 
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TTTTfl Renove Edit Hex Symb 



BREAK: Code Break-Point 



XBREAK: External Data Break-Point || 
I TRON : Trace-On-Po int 
TROFF: Trace-Off -Point 



Break/Trace \ Set \ Remove 



The Remove command is used to remove the currently highlighted break element. 

Break/Trace \ Set \ Edit 

If the Simple Break Window is the current window when the Edit command is selected, a Dialog Box will 
prompt you for an address range for a Simple Break. 

If the Complex Break Window is the current window when the Edit 
command is selected, a Pull-down Menu is called from which you 
can select which Complex Break field to edit a Code Address, a 
Direct Address, a Bit Address, an Opcode Value, an Opcode 
Class, or an Immediate Operand. 



Break/Trace \ Set \ Edit \ Code Address Range 



When the Code Address Range command is selected a Dialog Box will prompt you for a 
Code Address Range. Either a single address or an address range may be entered 
(numerically or symbolically). 

Break/Trace | Set \ Edit \ Direct Address Range 

When the Direct Address Range command is selected a Dialog Box will prompt you for 
a Direct Address Range. Either a single address or an address range may be entered 
(numerically or symbolically). 

When Complex Breaks are evaluated, a direct address (or range) is evaluated by 
searching the program loaded in code memory for instructions that have direct operands 
and then comparing the entered address (or range) with those operands when found. 

Break/Trace \ Set \ Edit | Bit Address Range 

When the Bit Address Range command is selected a Dialog Box will prompt you for a 
Bit Address Range. Either a single address or an address range may be entered 
(numerically or symbolically). 

When Complex Breaks are evaluated, a bit address (or range) is evaluated by searching 
the program loaded in code memory for instructions that have bit operands and then 
comparing the entered address (or range) with those operands when found. 

Break/Trace | Set \ Edit \ Opcode Range 

When the Opcode Range command is selected a Dialog Box will prompt you for an 
Opcode Range. Either a single opcode value or a range of opcode values may be 
entered. 
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uf.m Hex Symbolic 



Direct Address Range ► 
Bit Address Range ►- 
Opcode Range 
Opcode Class 
Immediate Operand Range 



ujjwui. \ui i tinge 



Break/Trace | Sef | £c//f | Opcode Class 

When the Opcode Class command is selected a Dialog Box will prompt you for an 
Opcode Class name (see Break/Trace | Set | Opcode Class below). 

When Complex Breaks are evaluated and the entered opcode class is found, the 
program loaded in code memory is searched for opcodes that match the opcodes found 
in that opcode class. 

Break/Trace \ Set \ Edit \ Immediate Operand Range 

When the Immediate Operand Range command is selected a Dialog Box will prompt you 
for a Immediate Operand Range. Either a single immediate operand value or a range of 
immediate operands values may be entered. 

When Complex Breaks are evaluated, an immediate operand (or range) is evaluated by 
searching the program loaded in code memory for instructions that have immediate 
operands and then comparing the entered immediate operand (or range) with those 
operands when found. 

Break/Trace \ Set \ Hex 

The Hex command toggles the Break Menu display mode to hex mode in which only numeric addresses 
and values are displayed. This mode has no effect on how addresses and values may be entered. 

Break/Trace \ Set \ Symbolic 

The Symbolic command toggles the Break Menu display mode to symbolic mode. In this mode addresses 
and values are displayed symbolically. In the Complex Break window the Ctrl-*- and Ctrl— » keys are used 
to scroll the displayed Complex Break fields. This mode has no effect on how addresses and values may 
be entered. 
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Break/Trace \ Set \ Opcode Class 



The Opcode Class command calls the Opcode Class 
Menu Window from which you can create or modify an 
opcode class. An opcode class is a user-defined group- 
ing of instructions. Each opcode class is made of one or 
many opcode class elements. Each opcode class ele- 
ment contains three fields, the Mnemonic, Operand 1 
and Operand 2. Opcode class elements can be added 
or removed and the fields of an opcode class element 
can be edited. 



When an opcode class element is evaluated the three fields are effectively ANDed together. Any field left 
blank is not included in the AND evaluation. 

Note that although the CJNE class of instructions has three operands, each CJNE instruction can be 
uniquely specified using the provided fields. 

Break/Trace \ Set \ Opcode Class [Add 

The Add command adds an empty Opcode Class element and automatically passes 
control to the Break/Trace \Set \ Opcode Class \Edit command. The added opcode class 
element is then highlighted (made the current opcode class element). 

Break/Trace \ Set \ Opcode Class | Remove 

The Remove command removes the current (highlighted) Opcode Class element. 

Break/Trace \ Set \ Opcode Class \ Edit 



When the Edit command is selected a Pull-down Menu is called 
from which you may name an Opcode Class, enter the opcode 
Mnemonic, and pick an operand for the Operand 1 or Operand 
2 field of the currently highlighted opcode class element. 

Break/Trace \ Set \ Opcode Class \ Edit \ Name 

The Name command allows you to name an Opcode Class. The name of an opcode class 
is special in that when an opcode class is saved (using Break/Trace | Set \ Opcode 
Class | Save), it is saved in a file name that is created automatically using the opcode class 
name. For example, if an opcode class is named "PGMFLOW" the file name the opcode 
class will be saved to is "PGMFLOWSOC". This is true of the Break/Trace | Set | Opcode 
Class \Load command as well. When the Load command is selected you will be 
prompted for the opcode class name to load. The software will look for a file whose 
name is created from the opcode class name in the manner described above. 
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Break/Trace | Set \ Opcode Class \ Edit \ Mnemonic 



The Mnemonic command allows you to edit the Mnemonic field of the currently 
highlighted Opcode Class element. Any valid instruction mnemonic is valid. 

Break/Trace \ Set \ Opcode Class | Edit \ Operand 1 

The Operand 1 command calls a Pull-down Menu from which you 
may select the type of operand to use for the Operand 1 field. The 
first operand of the MCS-51 instruction is often called the desti- 
nation operand. Note that the Operand 1 Pull-down Menu is the 
same as the Operand 2 Pull-down Menu. 



Break/Trace \ Set \ Opcode Class \ Edit \ Operand 2 

The Operand 2 command calls a Pull-down Menu from which you 
may select the type of operand to use for the Operand 2 field. The 
second operand of the MCS-51 instruction is often called the 
source operand. Note that the Operand 1 Pull-down Menu is the 
2 Pull-down Menu. 

Operands 

The set of choices in the Operands pull-down are: 



None 


no operand (used to remove an operand) 


Immediate 


immediate operand 


Direct 


direct address operand 


Bit 


bit address operand 


/Bit 


complemented contents of bit address operand 


Code 


code address (16-bit, 11-bit page and 8-bit relative) 


A 


accumulator operand (implicit) 


C 


carry bit operand (implicit) 


DPTR 


data pointer operand (implicit) 


PC 


PC operand (implicit) 


AB 


AB pair operand (implicit) 


@R0 


indirect register operand (implicit) 


@R1 


indirect register 1 operand (implicit) 


Rn 


specific general purpose register (n = through 7) (implicit) 


R0-R7 


any general purpose register (implicit) 



Break/Trace \ Set \ Opcode Class \ Load 

The Load command allows you to restore a previously saved (using 
Break/Trace {Set \Opcode Class \ Save) opcode class. If an opcode class is currently 
loaded in memory it will be cleared before the new opcode class is Loaded. When the 
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7-62 



Load command is selected you will be prompted for the opcode class Name to load. The 
software will search for the disk file for that opcode class. The file name used is created 
from the opcode class name. For example, if the desired opcode class is named 
"PGMFLOW" the file name searched for is "PGMFLOW.SOC". 



Break/Trace \ Set\Opcode Class 




The Save command is used to store the currently defined opcode class to a disk file that 
can be loaded (using Break/Trace] Set [Opcode Class] Load). The disk file name is 
created from the opcode class name. For example, if the opcode class name is 
"PGMFLOW" the opcode class will be saved to the file named "PGMFLOW.SOC". If 
the opcode class has not been named yet, you will be prompted to enter the name. 



Break/Trace \ Set \ Load 



The Load command allows you to restore a previously saved (using Break/Trace \ Set \ Save) break setup 
from a disk file. Any current break elements (Simple and Complex) are removed. 



Break/Trace \ Set \ Save 



The Save command allows you to store all the currently defined break elements (Simple and Complex) to 
a disk file. That file can then be loaded (using Break/Trace \ Set [Load) at a later time. 



Break/Trace \ Clear 



The Clear command is used to clear all breaks set through the Break Menu (Break/Trace \ Set). 

Break/Trace \ Disable 



The Disable command is used to temporarily disable all breaks set through the Break Menu 
(Break/Trace | Set). The breaks can be enabled using the Break/Trace \Enable command. Note that while 
breaks are disabled the Break/Trace \ Set, Break/Trace \ Disable, and Break/Trace] Clear commands are 
de-activated. 



Break/Trace \ Enable 



The Enable command is used to enable breaks originally set through the Break Menu (Break/Trace | Set) 
that were temporarily disabled using the Break/Trace {Disable command. 




Break/Trace \ Trace Trigger 



The Trace Trigger command calls a Pull-down Menu from 
which you may select Start, Center, End or Variable settings for 
the Trace Trigger. This Pull-down Menu is available on Model 
400 emulators only. 



Trace Trigger 
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The current value of the Trace Trigger is shown in the Status 
Window "Trig:" field and in the Break/Trace Pull-down Menu. 

The Trace Trigger controls when emulation stops, relative to the actual break-point, in terms of the 
amount of information captured into the trace buffer. 



Break/Trace \ Trace Trigger \Start 

When you select the Start Trace Trigger, emulation stops after approximately 4K trace frames accumulate 
in the trace buffer following the break-point. 

Break/Trace \ Trace Trigger\Center 

When you select the Center Trace Trigger, emulation stops after approximately 2K trace frames accumu- 
late in the trace buffer following the break-point. 

Break/Trace \ Trace Trigger \ End 

When you select the End Trace Trigger, emulation stops upon reaching the first break-point (i.e., zero (0) 
additional frames accumulate in the trace buffer following the break-point). 

End is the default Trace Trigger. 



Break/Trace \ Trace Trigger \ Variable 

When you select the Variable Trace Trigger, you can specify exactly how many trace frames will accumulate 
in the trace buffer following the break-point before emulation actually stops. 



Break/Trace | Break-Count 



You use the Break-Count command to specify the number of break-points to be reached (passed through) 
during real-time emulation before emulation actually stops. Unlike the Repetition Counter (Run {Repeti- 
tion Count on page 7-35), the Break-Counter is hardware controlled and operates nonintrusively during 
full-speed, real-time emulation. 

The Status Window shows the current Break-Count value in the "BrkCnt" field. 
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Break/Trace \ View Trace 



The View Trace command is available on Model 400 emulators only. 

The View Trace command calls the View Trace Window from which you may examine and/or write (to a 
file) the contents of the trace buffer. The trace buffer can be examined/written in several different display 
modes: Raw, Code, HLL and Mixed. 

Each frame of trace information contains the information recorded during one bus cycle. This information 
consists of the address (16 bits), data/opcode (8 bits), probe clip inputs (7 bits) and opcode fetch (1 bit). 

Break/Trace \ View Trace \ Raw 
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7-1. (Probes - Digital Waveform, Display Mode - Raw) 



The Raw command is used to set the Raw display mode. In the Raw display mode, you see the binary 
content of the address/data bus for each bus cycle (trace frame) in a raw hex format. 

The fields in the Raw mode display are: 



Frame Number the relative trace buffer frame number where the frame at the trigger 
point is numbered zero (0) 

Address the captured address value 

Data the captured data or opcode value 

Probes the captured Trace Input signal values (see Probe Clip Assembly) 

where a value of zero (0) reflects a low signal and a value of one (1) 
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The notations used in the Raw mode display are: 



**(LCALL) 
** 

R 

DMA 

? 

< < 



opcode-fetch cycle (beginning of instruction's execution) where the 
opcode mnemonic is displayed to the right of the asterisk 

interrupt (1st ALE cycle) 

interrupt (2nd 

Reset 

DMA activity 

same as "(uncertain)" in the Code display mode 

(Probe column) marks next instruction to be executed (not executed 
yet) 



Break/Trace \ View Trace \ Code 
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7-2. (Probes - Binary, Display Mode - Code) 

The Code command is used to set the Code display mode. In the Code display mode, you see the content 
of the trace buffer interpreted as fully disassembled instructions, including all available symbolic informa- 
tion (except HLL source images). 

The fields in the Code mode display are: 

Frame Number the relative trace buffer frame number where the frame at the trigger 
point is numbered zero (0) and the frame number displayed here is 
that of the last frame in the trace of the instruction's execution 

the captured address value in the first frame (first cycle) of the trace 
of the instruction's execution 

the label(s) for the instruction at address Code Addr (if there is more 
than one label at this address and they won't all fit in the Label field, 
iceMASTER displays the first label at this address with preference 
given to global (public) labels) preceded by a plus sign to indicate that 
there is more than one label at this address 



Code Addr 
Label 
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Cy the number of cycles in the instruction's execution where this is the 

same as the number of frames laid down in the trace buffer for the 
instruction 

Instruction the disassembled instruction at address Code Addr 

Probes the captured Trace Input signal values (see Probe Clip Assembly on 

page 3-6) where a value of zero (0) reflects a low signal and a value of 
one (1) reflects a high signal 

The notations used in the Code display mode are: 

interrupt 

Reset (only when in middle of an instruction) 

DMA activity (not part of instruction's execution) 

(unable to decode with absolute certainty because only part of an 
instruction's execution trace was captured in the buffer due to 
automatic wraparound in the circular trace memory in the emulator) 

(Probe column) marks next instruction to be executed (not executed 

yet) 

Break/Trace \ View Trace [Mixed 

The Mixed command is used to set the Mixed display mode. The Mixed display mode is a combination of 
the Code and HLL display modes. The HLL source images (HLL mode display), if available, appear 
interspersed appropriately with the generated machine code as in the Code mode display. An example of 
the Mixed display mode is shown under the description of the Search command (Figure 3). 

Break/Trace \ View Trace \ HLL 

The HLL command is used to set the HLL display mode. In the HLL display mode, you see the decoded 
content of the the trace buffer interpreted as HLL source language images. This can be done only if the 
iceMASTER system has access to the source/listing files corresponding to the modules in your program. 
Source languages supported include C and PL/M-51. 

Break/Trace | View Trace {Probes 

The Probes command cyclically toggles the display of the captured probe clip (see Probe Clip Assembly) 
bit values through three display modes: 

Binary (see Figure 7-2) 
Hexadecimal (see Figure 7-3) 
Digital waveform (see Figure 7-1) 

The Probes command and its associated display are available in the Raw, Code and Mixed primary display 
modes. 

The digital waveform display in the Raw display mode reflects every frame in the trace buffer. However, 
the waveform display in Code and Mixed modes reflects only the probe clip values in the first CPU cycle 
of each instruction's execution. Therefore, if a probe signal transitions during the CPU cycles of an 
instruction's execution, the displayed waveform may appear "broken". When you see this, you can switch 
into Raw display mode to get the complete picture. 

7-67 



♦LCALL 
*R* 

DMA Cycle 
(uncertain) 

<<<<<< 



Configure File 



Raw 



Code 
Mixed- 



Run Display/Alter Misc Source/Symbo 1 s Break/Trace Help 
Uieu Trace — — — ^ 
Mixed HLL Probes ggaBffl Urite 



-Trace Read: lBBx — 



Module Line Soi 



Frame 

Number Addr Labe 1 



799 8BF8 F_UASTE:*1 

795 BBFA 

793 88EF 

791 BBF8 

789 8BF2 

787 88F4 

783 88F6 

782 F UASTE 



^Search Trace Buffer* 



>earch for Address 



Direction: 
Address : 



A (older frames) ▼ (neuer frames) 



uaste :ttl4 



-Search for Frame Number- 



Frame Number: 



(Range: -3967... *8) 



Z SUBB A,883h 7F 
4 JMC 88FCh 7F 
14 } /» end of function: ' uastet ime ( ) ' »/ 

- 779 8BFC F_UASTE:»14 4 RET 7F 

- 778 F_ INNER 28 if (P1_B) 'CPL PI. 8': */ 

- 775 88CC F_INNER:»2B 4 JNB Pl_B.BBD3h 7F 

- 774 F_ INNER 23 P1_B = 1; /* if Pl.B off. set 

- 773 88D3 F_INNER:»23 Z SETB P1_B 7F 
'Trigger: End Ctrl-R:Resize Ctrl-U:Moue 

Search trace buffer for a specific code memory address or trace frame number 



r 



UieuTrc 3 



urMod 
nU.it i I 



7-3. (Probes - Hexadecimal, Display Mode - HLL) 

The Search command allows you to search the trace buffer for a particular address, label, source line 
number or trace frame. 

In searching for an address, label or source line number, the search commences from the current position 
in the trace buffer (the highlighted line in the middle of the window). You can search backwards in the 
trace buffer, looking for older trace frames, or forwards, looking for newer (more recent) trace frames. 

The «-, -», f and I keys are used to select which type of search is performed, and in which direction. 

Break/Trace \ View Trace \ Write 

You can write the entire trace buffer to a disk file by selecting the Write command. The format of the 
information written to that file will be just as you see it on the screen (i.e., in human-readable form, in the 
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Chapter 8: Run-Time Considerations 



The iceMASTER emulator is designed to be as close as is possible to an actual device. In most cases you 
will not be aware of any difference since the devices used to emulate are the actual microcontrollers 
themselves. Since we do need to know what is going on during emulation there are a few constraints placed 
upon us, and a few precautions you can take to prevent problems. 

Static 



Perhaps the most difficult problem anyone who uses MOS devices will face is static. You may go for years 
with no fault traceable to static, or you may blow every part you touch. The iceMASTER emulator can be 
as sensitive to static as any other circuit. The microcontroller devices in the probe cards are especially 
vulnerable since adding extra protection would change response characteristics. This would be a step 
away from the real world. The built-in protections internal to the devices are operative. 

We do still recommend, however, that you take every precaution regarding static. The use of grounding 
straps, static free workstations, and a little extra care in handling the emulator (and any MOS part) can 
prevent troubles later. 

Power 

When starting an emulation session, always turn the emulator power on first, then apply power to your 
target system. This will ensure that any interface devices are initialized properly. If you need to test a 
power-up initialization routine in your target, power up the emulator first, load your program if necessary, 
begin execution of your program using the Run \ Reset \ Target command (page 7-33) which will cause the 
emulator to wait for a reset to arrive from the target, then power up your target and be sure that the 
power-up sequence includes a valid reset after the target is initialized (which is a good design practice 
anyway). If you are working in a target application which uses less than + 5V, this is acceptable if: 

1) The microcontroller on the probe card can be powered from the target system, and 

2) The voltage levels on the signals which we monitor meet minimum TTL levels. Note that the 
emulator base monitors port 0, port 2, XTAL 1, #RD, #WR, ALE, and #PSEN. 

Please remember that we provide power for the microcontroller on the probe card (unless a jumper allows 
the user to connect the VCC line to the target power pin(s)). Therefore, you should be sure the two VCC 
levels are close enough that the guaranteed logic high and low values are met. It is also necessary that you 
do not exceed the input pin voltage ratings of the devices on the probe card which allow communication 
with the base. We recommend that power be maintained at + 5V + /- 5%. If you have any questions about 
a specific application, please contact us (page 1-1). 
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/RD And /WR Control Signals 



In the 8051 family, the port register bits P3.6 and P3.7 (which correspond with the /RD and /WR control 
signals) must be set high in order to function normally. This is a device characteristic. The iceMASTER 
emulator monitors these lines to obtain data about MOVX instruction executions. If you are using either 
pin as a port pin, or if you allow other devices to pull either pin low independent of the microcontroller, 
be sure this does not happen concurrent with a MOVX instruction. If both /RD and /WR are active low 
during a MOVX, the emulator base may exhibit abnormal behavior. 

Some probe cards provide jumpers to hold the /RD and or /WR monitor lines to the base high in these 
cases. If yours does not, simply be sure that the MOVX can not occur at a time that will allow both of the 
/RD and /WR lines to be low at the same time. 

Clock Drivers 

Many of the external clock drivers commonly used provide TTL level outputs. This can be a problem for 
not only the emulator but your target design as well. Most CMOS processors require a CMOS oscillator 
or clock levels to function reliably. 

Do not use NMOS or HMOS parts to replace the microcontrollers on probe cards not designed for them. 
They are not guaranteed to work and doing so will void your warranty. 

In the 8051 family, some NMOS processors had clock circuits that required XTAL 2 to be driven and 
XTAL 1 to be grounded. Most CMOS processors require XTAL 1 to be driven and XTAL 2 to be left 
floating. This presents a problem when using a CMOS part in an application designed for an NMOS part. 
Please refer to Chapter 4, the Probe Card Reference for settings (if available) to compensate for this. This 
is only a problem when using an external clock driver, as crystals are usually symmetrical enough that it 
doesn't matter. 

Timer Values 



The iceMASTER emulator automatically turns off all timer/counters when emulation stops. If a 
timer/counter is running when a breakpoint is encountered, it is stopped several machine cycles after the 
breakpoint. This characteristic can cause edge-sensitive routines to "malfunction" if breakpoints are set 
such that emulation stops before the edge is active. This applies to timer functions and edge-triggered 
interrupts. The work around: don't single-step or set breakpoints through instructions that look for or 
generate the edges. 

If a timer/counter is turned on before beginning an emulation for the first time (by setting the appropriate 
bits in the TCON register using the DisplaylAlter\VarlReg command page 7-40), the timer/counter will 
actually be turned on several machine cycles before the first instruction is executed. 

If a timer/counter is turned on for an emulation which must be restarted (i.e., execution has already 
stopped at a breakpoint), the timer/counter will be turned on several machine cycles before full speed 
emulation begins again. 
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Port Registers 



The values for the ports which are displayed via the SFR displays represent the actual values at the port 
pins and not the value in the port registers. If the value of one of the output pins is to be changed, care 
must be taken to ensure that a 1 is written to any input pins in the same port (otherwise they will become 
output pins). 

Idle and Power Down Modes 

During emulation, the status message 

Probe Card Processor Inactive 

may be displayed. This status message indicates that there is NO ALE signal reaching the emulator base 
from the probe card. Normally this will be due to the entry of Idle mode or Power Down mode on CMOS 
devices. If this condition occurs for any other reason, see Chapter 9, Troubleshooting. 

If a device is in Idle or Power Down mode, and you execute a Host-break (i.e., manually breaking 
(stopping) emulation by pressing Esc), a Confirmation Box will prompt you with the following: 

Processor not running, do you want to RESET to break emulation? 

A Y response will reset the system and emulation will break at address 0. A N or ESC response will leave 
the device in its current state. Breaking emulation by pressing the break button on the iceMASTER 
emulator base has the same effect. 

After successfully entering the Idle or Power Down state, no further instructions are executed so no preset 
breakpoints will be encountered. ALE is high during Idle and low during Power Down. The iceMASTER 
emulator can be put into the CMOS reduced-power modes either under program control or (in most 
microcontrollers) by modifying the appropriate register (using the interactive capability of the register 
window or through the Display/Alter \ Var/Reg command on page 7-40). In order to invoke these modes of 
operation, the probe card must support the CMOS versions of its respective controllers. 

Any interrupt request or a hardware reset will bring the emulator out of Idle mode. If the Idle mode is 
terminated with a hardware reset, the contents of the SFR's and GPR's will be lost. The communication 
link between the emulator and the Host Computer will also have to be re-established. 

When in Power Down mode, the emulator must be reset in order to regain the communication link. For 
instance, if Power Down is invoked and then the Host-break function is executed (Esc key is pressed), you 
will be asked whether or not a hardware reset is to be performed. It is not mandatory to reply Y. It is, 
however, the quickest way to re-establish the communications link and resume emulation. 

Microcontroller Serial Port 



After breaking emulation (by breakpoint or Host-break), all interrupts are disabled. A serial port transmit 
or receive interrupt which occurs after the breakpoint has been encountered will be ignored. 

Whether the Host Software writes to SBUF via the Display/Alter | Var/Regs command (page 7-40) or the 
program code writes to SBUF (e.g, MOV SBUF,A) the register window will not display the value written 
to SBUF. This is because a write operation to SBUF writes the value to the serial port transmit buffer and 
the read SBUF (to display the value) operation reads the serial port receive buffer (they are separate). 
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Watchdog Timer 



For all devices with a Watchdog Timer, in order for the Reset Count in the Main Status Window to 
accurately reflect the number of watchdog resets, the oscillator clock frequency must be 16MHz or less. 
At greater than 16MHz, the emulator base will begin to miss watchdog resets and the Reset Count will be 
wrong, although the device will actually perform the reset and the trace buffer will reflect the event. If a 
watchdog reset should happen just after a break condition, before the emulator can refresh the WDT 
registers, there is a small possibility that the emulator base could get out of synchronization with the 
device. The values in the SFR's may be displayed incorrectly, and the trace buffer data may be corrupted. 
To re-synchronize the emulator base and the device the user must start the next emulation with a reset. 

If you have any further questions about emulators we will be happy to discuss your application. 
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Chapter 9: Troubleshooting 



Before starting any fault investigation, remove the emulator from the target system and configure the 
probe card for stand-alone operation. Make sure that all connectors are in good condition and fully 
seated. Take note of any physical damage to the unit. 

Several common problems are covered in this chapter. If this isn't enough to get the emulator back into 
operation, contact MetaLink (see page 1-1). 

With your knowledge of the application and MetaLink's knowledge of the emulator, many problems can 
be diagnosed within a few minutes. 

Before Calling 



Have the system near the phone so that problems may be "walked through". If the unit needs to be sent in 
for repair you will also need the following information: 

1) the emulator's serial number (on the bottom of the emulator base unit) 

2) the software revision level (see Configure \ Identification on page 7-20) 

3) the address to which MetaLink will ship the repaired unit 

Power Indicator LED Is Not Lit 

If the power indicator LED is not lit, check the usual background details, such as that the power switch is 
ON, the power is connected to the unit and the AC circuit breaker is ON. If these items are in order, make 
sure that + 5V is delivered to the emulator's power connector by checking the output of the + 5V power 
supply. Examine the emulator power connector drawing in the Hardware Installation chapter to deter- 
mine the pin-outs for the male DIN connector. 

Using a voltmeter, check the terminals of the power supply. If the output is correct, check the + 5V at the 
probe card (with the emulator power switch ON). The easiest place to read this is across the large power 
filter capacitor on the probe card. If this reading is not + 5V ( +/- 5%), the problem may be in either your 
emulator or in your power supply. If you have another power supply capable of providing + 5V at 1.5 
Amps (+/- 5%), try it. If this does not solve the problem, the emulator needs to be repaired. Contact 
MetaLink (see page 1-1). 

Active Indicator LED Is Not Lit 



If the Active LED is not lit, make sure that the probe card's crystal jumpers are set correctly for the 
application. Refer to the Probe Card Reference for your probe card. The probe card may be configured 
to support clock drivers for either CMOS or NMOS controllers, regardless of the technology of the 
microcontroller on the probe card. Make sure that the jumper blocks have not been damaged and are 
making good contact at their respective posts. 

Once the crystal jumper block settings have been verified as correct, make sure that the Power Down 
mode or Idle mode of operation (CMOS controllers only) was not inadvertently invoked through 
software. A Reset is the only way to terminate the Power Down mode. If the Active LED stays unlighted, 
contact MetaLink (see page 1-1). 
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Communications Failure 



Make sure that the oscillator signal is present. If a crystal is used, the crystal itself may be damaged. 
Replace the crystal with an equivalent crystal if the no-signal condition remains. If the oscillator is present, 
check the probe card cable at its mating connectors. 

Also check the cable for damage which may have introduced a fault in the signal activity. Replace the cable 
with an equivalent if flaws are seen. Refer to Chapter 3, Hardware Installation for details on the cable 
construction. 

Next, compare the RS-232 cable with the illustration in the Hardware Installation chapter. Replace the 
cable if needed. A "break-out box" will facilitate a check on the presence and level of the RS-232 signals 
on the cable. Active signals will be at a nominal 10V and the polarity may be plus or minus depending on 
the state the of the hardware. If no activity is seen on Pin 2 (Transmit) the Host Computer has a fault in 
its interface card. If Pin 2 is active and Pin 3 is inactive (not toggling) the emulator has a fault. A persistent 
fault may indicate that the probe card's microcontroller has been damaged. Replace the controller with 
an equivalent. If the fault remains, contact MetaLink (see page 1-1). 

Emulation Problems 



In stand-alone mode, load and run the program DEMO.DBG that is supplied on the distribution 
diskettes. If the program runs correctly, the problem may not be with the emulator but with the emulator 
target interface. Keep an open mind. Even in known good target systems, failures occur. It may even be 
possible for a "real" device to work in your target where the emulator has trouble. This is usually a problem 
with tolerances, not differences. If you encounter this, please call us so we can determine quickly where 
the problem lies. 

Carefully consider the application: 

1) verify that the emulator is configured properly (see Chapter 4, the Probe Card Reference) 

2) verify that mapping is set properly 

3) look for unexpected resets (e.g., watchdog timers) 

4) check interrupt routines for proper returns to normal code execution 

If these procedures restore operation in the stand-alone mode, or if the unit worked in the stand-alone 
mode without correction, it is necessary to determine if the target is causing the fault or if the emulator 
has a fault that doesn't manifest in stand-alone mode. 

Troubles to watch for include: 

1) Watchdog Timer resets during BREAK condition 

2) bus contention 

3) excessive loading 

4) failed components in the target system (especially failures that are likely to damage the probe card 
or emulator base) 

If you have any questions contact MetaLink for technical assistance (see page 1-1). 



Appendix A: Tutorial 



This tutorial will help you become familiar with the operation of MetaLink emulators. This is an 
introduction and is by no means an in-depth explanation of how the iceMASTER emulator functions, nor 
does it fully explain its capabilities. Once you have completed the tutorial you will be ready to begin 
experimenting on your own and with the help of this manual to be able to understand and master the 
emulator. 



Before You Begin 



Make sure the software and hardware is installed (see Chapter 3, Hardware Installation and Chapter 5, 
Software Installation) and then read the Software Guide (Chapter 6) to familiarize yourself with the layout 
of the screen and the terminology used to describe the software system. 

This tutorial assumes the emulator is functioning and is at hand ready-to-use. Throughout this tutorial we 
will refer to the iceMASTER emulator simply as the emulator. The iceMASTER Host Software is a 
windowed interface which allows access to most data directly from the Main Menu. Most windows can be 
resized, repositioned, activated or inactivated at your discretion. The Software Guide (Chapter 6) and 
Command Reference (Chapter 7) contain details on how to make these changes. For now, let's get right 
to some useful activities. 



Begin 



Begin by changing to the drive and directory in which you have installed the Host Software (we will assume 
the installation procedure default drive and directory, C:\IM51), as follows: 

C: 

CD \IM51 

You are now ready to invoke the Host Software, as follows: 
ICE 

The initialization screen will appear and list the activities being performed as initialization proceeds. 
When this process is complete, the Main Menu Windows will be displayed, but since communication 
between the emulator and the Host Software has not been established no data will be displayed in the 
windows. In addition, since communication has not been established, several levels of Pull-down menus 
will be invoked so that the currently highlighted command is Configure \ Emulator] Execute (see page 7-2), 
which is the command used to establish communication between the emulator and the Host Software. 

The files DEMO.DBG and F DEMO.AOM will be used in this tutorial session (DEMO_751.DBG for 
the 83C751 and 83C752). DEMO.DBG (or DEMO_751.DBG) contains full symbolic information as 
generated by MetaLink's ASM51' absolute macro cross-assembler with the SDEBUG directive set. 

FDEMO AOM contains full, extended symbolic and source-level information as generated by Franklin's 
'C-51' compiler. Rather than describing the emulator, let's run it. Learning by doing is often the shortest 
path to learning a new skill (or a new applications program). 
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Establish Host-to-Emulator Interactive Communication 



Before establishing communication you need to verify the communication port selected and the chip 
mode of operation. The communication port listed in the Pull-down Menu next to the Configure \ Emula- 
tor | Comm port command (page 7-3) should be the communication port installed in the Host Computer. 
The chip mode of operation listed in the Pull-down Menu next to the Configure \ Emulator \ Mode 
command (page 7-2) should be the default for your microcontroller, as specified in the Probe Card 
Reference (Chapter 4). 

To establish communication, select the Configure \ Emulator \ Execute command. As communication is 
established various Status Boxes will be displayed to inform you of the operations that are taking place. 
When the Pull-down Menus are popped (removed from the screen) and the Main Screen Windows are 
repainted (with all data) we are ready to go. 



Load A File Into The Emulator 



We are now ready to load a file into the emulator. The files we will use for this demonstration are: 

DEMO.DBG DEMO.DBG is the load file from an assembly language program which contains full symbolic information 
as generated by MetaLink's ASM51 absolute macro cross-assembler (using the SDEBUG directive). 
Note that the Tutorial description will specify DEMO.DBG in places, but if you are using an 83C751 or 
83C752 you should substitute DEMO_751.DBG. 

F_DEMO.AOM F_DEMO.AOM is the load file from a C program which contains full, extended symbolic and source-level 
information as generated by Franklin's C-51 compiler. 

To load a file, select the File Pull-down Menu and then select the Load command (page 7-27). Note that 
we will sometimes refer to a sequence of commands by separating each command by a vertical bar, in this 
case File \ Load. 

A Filename Dialog Box will then prompt you for the name of the file to be loaded. Note that Filename 
Dialog Box includes a directory listing capability. Let's use it to find the name of the file you will be 
loading. At the file name prompt press ?. A Dialog Box will then prompt you for the drive and path to list 
a directory for. To select the current directory simply press Enter. A directory listing will be displayed (the 
same information produced by the DOS 'DIR /W/P' command). The file DEMO.DBG should be one of 
the files listed. 

Note that pressing ! (rather than ?) will result in the directory listing complete with date/time stamp and 
file size information (the same information produced by the DOS 'DIR /P' command). 

The Host Software assumes that the file is in the current directory unless a path is specified. Path names 
and filenames follow DOS conventions. After the directory is listed, the message 

Press any key to continue 

is displayed. Press a key and then enter the file name at the prompt. A Confirmation Box will then ask 

Merge into current application environment? 

Respond Y to retain the current application environment, including breakpoint settings, trace ON/OFF 
points and all symbolic information. Respond N to clear the current application environment before 
loading a new file. 

For our situation, respond N. Various Status Boxes will be displayed to inform you of the progress of the 
Load while the file is loading. 
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The Quick Help line at the bottom of the screen shows the following status: 

Read Address: xxxx — offset into file of current code image record being read from file. 
Load Address: xxxx — address of first byte in block being written to emulator base unit. 

Demo Program Overview 

Before going further, let's take a look at the programs we are going to be working with. The purpose of 
the programs is to output a pulse train on Port 1, Pin (P1.0). The pulse train is a continual repetition of: 

1) a series of 5 positive going pulses of equal duration 

2) a skipped pulse 

The pulse train appears as follows: 



There are three control loops in these programs. They are: 
WASTETIME WASTETIME executes ninety (90) bus (ALE) cycles before exiting. 

INNERLOOP INNERLOOP is responsible for generating the 5 pulses. It accomplishes this by calling the WASTETIME 
routine to generate the pulse width and spacing. It then changes the polarity of the output pin. The 
accumulator in DEMO.DBG and the variable 'STATE' in FDEMO.AOM are used to reflect the state 
of the output pin. 

OUTERLOOP OUTERLOOP is a simple, infinite loop. It uses INNERLOOP to generate the 5 pulses and then calls 
WASTETIME twice to generate the blank pulse between sets of 5 pulses. Notice that the Data Pointer 
(DPTR) in DEMO.DBG or the variable 'COUNTER' in F DEMO.AOM is used to count the number 
of transmitted sets of 5 pulses. 
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The DEMO.DBG Program 







1 


$debug 








2 
3 


$nopaging 






0090 


4 


outbit 


BIT 


y un 


0064 




5 
6 




DSEG AT 


64h 


0064 




7 
8 


tempcount : 


DS 


1 






9 




CSEG 




0000 


020030 


10 




LJMP 


start 






11 








0030 




12 




CSEG AT 




0030 


900000 


13 


start: 


MOV 


DPTR, #0 


0033 


C290 


14 


outerloop: 


CLR 


outbit 


0035 


75640A 


15 




MOV 


tempcount ,#10 


0038 


120050 


16 


innerloop: 


CALL 


wastetime 


003B 


B290 


17 




CPL 


outbit 


003D 


E4 


18 




CLR 


A 


003E 


309001 


19 




JNB 


outDit , sjcipover 


0041 


F4 


20 




CPL 


A 


0042 


D564F3 


21 


skipover : 


DJNZ 


tempcount, innerloop 


0045 


A3 


22 




INC 


DPTR 


0046 


120050 


23 




CALL 


wastetime 


0049 


120050 


24 




CALL 


wastetime 


004C 


80E5 


25 




JMP 


outerloop 


004E 


80E0 


26 


endof program: 


JMP 


start 






27 












28 


• 






0050 


78FF 


29 


wastetime : 


MOV 


R0, #0FFh 


0052 


D8FE 


30 




DJNZ 


R0,$ 


0054 


22 


31 




RET 








32 












33 




END 





Figure A- 1. DEMO.LST 

Now that a file is loaded in the emulator's code memory, we are ready to begin an emulation session. This 
is monitored and controlled from the Main Menu. 

Let's start by running the program by selecting the Run | Reset | Emulator command (page 7-33) . When this 
command is selected, the emulator base unit will reset the device in the probe card (and execution of the 
DEMO.DBG program will begin). The message RESET is displayed in the Status Window, to show how 
emulation was started. This message will be displayed until emulation is halted, at which time the reason 
for the break will be displayed. Also, notice that the PC Address and Execution Time are updated 
approximately every 1.5 seconds to indicate emulation activity. 

Since there are no breakpoints currently set, press the Esc key to stop emulation. Note the changes in the 
Main Screen windows. 

The SFR's (Special Function Registers) and GPR's (General Purpose Registers) are updated to reflect 
the values present in these registers at the instant emulation was stopped. 

The PC (Program Counter), Break Address and DPTR (Data Pointer) located in the Status Window are 
updated to reflect current values. In this case, the Break Address will be the same as the PC. 

A-4 



The next instruction to be executed is highlighted in the Source Window, along with the value of any 
indirect operands for that instruction. 

Pressing Esc during emulation forces a break on the emulator. This is called a Host-break. This is just one 
way that the user can stop emulation. 

Setting Breakpoints 



An iceMASTER emulator has four ways to break emulation: 

1) set a breakpoint using the Break Menu (Break/Trace | Set, page 7-57) 

2) pressing the Esc key (Host-break during emulation) 

3) pressing the Break push-button on the emulator base 

4) using the Break Input probe clip on the probe card 

Let's set a simple breakpoint first. Select the Break/Trace Pull-down Menu and then select the Set 
command. The Breakpoint Menu will be displayed. The Breakpoint Menu is divided into two parts, 
simple breaks and complex breaks. The heading Simple should be highlighted. To move between Simple 
and Complex Windows use the Tab or Shift-Tab keys. From the Simple Break Window you may: 

1) set a code breakpoint (or range of breakpoints) 

2) set an external data breakpoint (or range of breakpoints) 

3) set a trace ON or OFF point (or range of points) (Model 400 emulators only) 

Select Add. A Pull-down Menu will show four choices (page 7-58): 

1) CBREAK: Code Break-Point 

2) XBREAK: External Data Break-Point 

3) TRON: Trace-On-Point 

4) TROFF: Trace-Off-Point 

Note that the TRON: Trace-On-Point and TROFF: Trace-Off-Point commands will be de-emphasized and 
unavailable if the emulator is not a Model 400. The XBREAK: External Data Break-Point command will 
be de-emphasized and unavailable if the device being used does not have access external data memory 
(e.g., the 83C751 and 83C752). 

Select the CBREAK: Code Break-Point command. A Dialog Box will prompt you for the address range. 
Enter at the start address prompt. The cursor then automatically advances to the end address prompt. 
An entry at this prompt will specify a range of breakpoints, start address through end address, inclusive. 
Press the Enter key so that the break will be set at just address 0. 

Repeat the Add \ CBREAK: Code Break-Point command sequence and enter the next code breakpoint 
symbolically. Enter WASTETIME at the start address prompt and press Enter at the end address prompt. 
Note that you can toggle the display mode of the Break Menu to symbolic mode (break addresses 
displayed symbolically) by selecting the Symbolic command (page 7-60) and to hex mode (break addresses 
displayed in hexadecimal) by selecting the Hex command (page 7-60). 

Now that we have set some breakpoints press Esc to return to the Main Menu and select the 
Run \ Reset\ Emulator command sequence (page 7-33) to begin emulation. The breakpoint at location 
will be encountered immediately. The Status Window should show that the PC and the Break Address are 
both 0. Now select the Run | Go command (page 7-33) to resume execution from the current PC. In a few 
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moments, the bre 



at WASTETIME is reached and emulation will stop. Now select the Run | Go 
Now let's have a look at the Trace Buffer (Model 400 emulators only). 



Viewing The Trace Buffer (Model 400 Emulators only) 



Trace is always enabled at the start of emulation and trace information will always be captured unless you 
turn trace OFF using the Break/Trace \ Set \Add \ TROFF: Trace-Off-Point command (page 7-58). There- 
fore, it is not necessary to turn trace ON at every point where you may want to begin emulation. 

You may view the data captured in the trace buffer by selecting the Break/Trace \ View Trace command 
(page 7-65). Frame number should show the address at location WASTETIME (50h, or 4Dh if using 
DEMO_751.DBG) in the trace buffer is the breakpoint. The default trigger point (END) is at the end of 
the stored data. Therefore, all trace data is behind (earlier than) the trigger. 

Let's select the Search command (page 7-68) to search for a specific frame in the trace buffer. In the 
Search Dialog Box, use the | key to highlight the frame number field and then enter -3967. This will cause 
a search for the trace frame 3967 frames prior to the trigger point at frame number 0. The Trace Buffer 
repaints the display to show the specified frame (on opcode fetch boundaries), or the next best thing. In 
this case,the next best thing is the top of the Trace Buffer at about frame number -1043. 

Let's select the Search command again and search for a specific address in the trace buffer. In the Search 
Dialog Box highlight the address field and then enter INNERLOOP. Note that the «~ and -» keys allow 
you to toggle between the forward and backward search directions. There will be a slight delay as the 
software searches ahead in the Trace for the first occurrence of the symbol INNERLOOP. In this case, 
the label is found at frame number -0001. 

To move around in the trace buffer the Home key takes you to the top (start) of the data, the End key takes 
you to the bottom (end) of the data, and the PgUp and PgDn keys move up or down (respectively) one 
page of data. Try it. 

Select the Raw command (page 7-66) to change the display mode of the trace buffer from Code Mode 
(disassembled instructions) to Raw Mode. Trace data is now displayed in raw hexadecimal form, with 
instruction fetches marked by an asterisk and the mnemonic opcode. There is one trace frame for each 
ALE cycle, and each of these frames is displayed in the Raw Display Mode. Now select the Code 
command (page 7-65) to return to the Code Mode. Press the Esc key to return to the Main Menu. 
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The F_DEMO.AOM Program 



/* File: f_hlmain.c */ 

/* C Language Demo Program ' F_DEMO . AOM ' (AOM == Absolute object Mod- 
ule), 

** for use with the Franklin/Keil 8051 C Cross-compiler, 
** Version 2.12 or later. 

** Versions actually used here: Compiler: V3.06 (Professional Edi- 

tion) 

** Assembler: V4 . 4 

** Linker: V2.7 

** 

** This program replicates, as closely as possible (except for actual 
timing) , 

** the functionality of the ASM51 demo program ' demo. asm' . 
** 

** Modules (Files) in F_DEMO . AOM : 

** f_vect.a51 — Assembly Language: reserves space for interrupt 
vectors 

** f_hlmain.c — • C, main program (function 'main( ) ' ) 
** f_inner.c — C, function ' innerloop ( repeat_cnt )' 
** f_waste.c — C, function ' wastetime ( ) ' 
* / 

♦include <stdio.h> 

sbit PI = 0x90; /* Pl.O */ 

/* external function prototypes (interface specifications) */ 
extern void innerloop (char ) ; 
extern void wastetime (void) ; 

char state /*= 0*/; /* 'state' reflects value in ACC (in original 
demo. asm) */ 

static char counter; /* dummy counter (rolls over at 256) */ 

void main ( ) 
{ 

state =0; /* mimic ACC Power-Up Reset condition (value) */ 

for ( counter =0; ; counter++ ) { 

P1_0 =0; /* Set Pl.O low at start */ 

innerloop( 10 ) ; /* Generate 5 pulses */ 

wastetime(); /* Call 'wastetime' twice to generate */ 

wastetime(); /* blank pulse between sets of 5 pulses */ 

} /* end of: for 'counter' */ 



} /* end of function: 'main()' */ 



Figure A-2. F HLMAIN.LST 
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/* File: f_inner.c */ 
♦include <stdio.h> 

/* external function prototypes (interface specifications) */ 
extern void inner loop ( char ) ; 
extern void was tetime (void) ; 

/* external variables */ 

extern char state; /* 'state' reflects value in ACC (in original 
demo. asm) */ 

sbit PI = 0x90; /* Pl.O */ 
— 

void innerloop( char repeat_cnt ) 
{ 

static char i; 

for ( i = 0; i repeat_cnt; i++ ) { 
wastetime ( ) ; 

if (P1_0) /* 'CPL Pl.O': */ 

Pl_0 = 0; /* if Pl.O on, clear Pl.O */ 

else 

P1_0 = 1; /* if Pl.O off, set Pl.O */ 
state = 0; 
if ( P1_0 ) 

state = (state) ? : 1; /* 'CPL A' */ 
} /* end of: for 'i' */ 

} /* end of function: ' innerloop( repeat cnt )' */ 



Figure A-3. FJNNER.LST 



/* File: f_waste.c */ 

/* external function prototypes (interface specifications) */ 
extern void wastetime (void) ; 

void wastetime ( void ) 

static char i; 

for ( i = 0; i 3; i++ ) { 

f 

} /*for*/ 

} /* end of function: ' wastetime () ' */ 



Figure A-4. FJVASTE.LST 



A-8 



Now that we've run an assembly language program and viewed the trace results, let's explore the 
emulator's HLL (High Level Language) capabilities using the program F DEMO.AOM. This program 
has been compiled and linked using Franklin's C-51 compiler and linker. 

First, let's load the new file using the File\Load command. Enter F_DEMO.AOM and reply N to the 
merge prompt. This will clear the current environment set during the DEMO.DBG session. 

Setting Breakpoints Revisited 



Let's set another simple breakpoint. Select the Break/Trace \Set \Add \ CBREAK: Code Break-Point com- 
mand. Enter for the start address and simply press Enter at the end address prompt. 

Select the CBREAK- Code Break-Point command again. This time however, enter the start address using 
a source line number (see Appendix E, Using Symbols) as follows: 

F_HLMAIN:#35 

and again simply press Enter at the end address prompt. 

Return to the Main Menu by pressing Esc and then select the Run \Reset \ Emulator command to begin 
emulation. The breakpoint at location will be encountered at once, as it was during the DEMO.DBG 
session. Select the Run \ Go command to resume execution from the current PC. In a few moments, the 
breakpoint at location of the line number "F_HLMAIN:#35" is reached. Note that the source level 
statements will be present in the Source Window (we broke on line number 35 in F HLMAIN so that line 
is highlighted as the next instruction to be executed). Now select the Run \ Go command sequence once 
more. Now let's have a look at the Trace Buffer (Model 400 emulators only) again. 

Viewing The Trace Buffer Revisited (Model 400 Emulators Only) 



Select the Break/Trace | View Trace command. The address at line 35 of HLMAIN (the breakpoint) is at 
the trace trigger point (END). Select the Search command to search for an address and enter 
F_HLMAIN:#35 at the address prompt. The first occurrence will be displayed. Repeat the Search and 
you will be moved back to the previous occurrence. You may have noticed that the previous entry in the 
search box was remembered the second time you used it. This is a convenient way to "search again" for 
another occurrence of the same item. Now press Esc to return to the Main Menu. 

Complex Breakpoints 



The Break Menu (Break/Trace \ Set) allows complex breakpoints to be created. The method is much the 
same as using simple breakpoints, but you may AND together code address, direct addresses, bit 
addresses, opcode values, opcode class (see Break/Trace \ Set \ Opcode Class on page 7-61), and immediate 
operands. 

First let's clear all current breakpoints by selecting the Break/Trace \ Clear command (page 7-63). Now 
return to the Break Menu (Break/Trace | Set) and press Tab to enter the Complex Break Window. Let's set 
a complex breakpoint to halt execution on any 'MOV A,Daddr' instruction located within the subroutine 
WASTETIME. In order to do this, we can specify the start address and end address using line numbers. 

To determine which line numbers span this routine we can use the Source/Symbols | Line Number window 
(page 7-54). From this display we can see the the function WASTETIME starts at F_WASTE:#10 and 
ends at F_WASTE:#14. 
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Now we can add a complex break. Select the Break/Trace] Set \Add \ CBREAK: Code Break-Point com- 
mand. In the Complex Break Window this automatically calls the Break/Trace \Set \Edit Pull-down Menu 
(page 7-59) from which you can choose which part of the complex break to enter (such as a code address 
range, direct address range, etc.). Select Code Address Range and enter F_WASTE:#10 for the start 
address and F_WASTE:#14 for the end address. 

Return to the Edit Pull-down Menu and select Opcode Value and enter the value 0E5 (a hexadecimal 
number) which is the opcode for the instruction we are interested in. Now press Esc twice to return to the 
Main Menu. Note that the conditions you have defined will be evaluated to achieve the following 
condition: 

if ((PC > = F_WASTE:#10 AND PC < = F_WASTE:#14) AND opcode = 0E5H) then Break 

Now select the Run \ Reset \ Emulator command to start emulation. Emulation will halt at the first 
occurrence of the above condition. Note that breakpoints may be saved to a file using the 
Break/Trace] Set \ Save command (page 7-63) and recalled later using the Break/Trace \Set\Load com- 
mand (page 7-63). 

Conclusion 



This concludes the tutorial for the iceMASTER emulator. Please use the Help command in each menu 
to learn about and experiment with the capabilities and power of the iceMASTER emulator. Help is 
accessed by highlighting the command of interest and pressing Hot Key Fl. Once a screen is displayed, 
highlighted topics can be hyperlinked or accessed in a read-more-about-it manner. To select a Hyperlink 
topic, press the Tab key to highlight the desired subject and press Enter. Esc will reverse the procedure. 
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Appendix B: Predefined Byte And Bit Addresses 



The following tables detail the predefined byte and bit addresses for the 8051 family of microcontrollers 
supported by the MetaLink family of emulators. Proliferation parts are delimited from the standard 
MCS-51 definitions by boxes. 



Predefined Byte Addresses 



P0 


DATA 


080 H 


;PORT 




SP 


DATA 


081 H 


; STACK POINTER 




DPL 


DATA 


082H 


;DATA POINTER - 


LOW BYTE 


DPH 


DATA 


083H 


;DATA POINTER - 


HIGH BYTE 



80C321/80C521 

DPL1 DATA 084H ;DATA POINTER LOW 1 

DPH1 DATA 085H ;DATA POINTER HIGH 1 

DPS DATA 086H ;DATA POINTER SELECTION 



83C152/80C152 

GMOD DATA 084H ;GSC MODE 

TFIFO DATA 085H ;GSC TRANSMIT BUFFER 



80C517/80C537 

WDTREL DATA 086H .-WATCHDOG TIMER RELOAD REG 



PCON 


DATA 


087H 


POWER 


CONTROL 




TCON 


DATA 


088H 


TIMER 


CONTROL 




TMOD 


DATA 


089H 


TIMER 


MODE 




TLO 


DATA 


08AH 


TIMER 


- LOW 


BYTE 


TL1 


DATA 


08BH 


TIMER 


1 - LOW 


BYTE 



83C751/83C752 

RTL DATA 08BH ; TIMER - LOW BYTE RELOAD 



THO DATA 08CH ; TIMER - HIGH BYTE 

TH1 DATA 08DH ."TIMER 1 - HIGH BYTE 

83C751/83C752 

RTH DATA 08DH ; TIMER - HIGH BYTE RELOAD 



83C752 

PWM DATA 08EH ;PULSE WIDTH MODULATION 



P1 DATA 090H ;PORT 1 



B-1 



I 83C152/80C152 

P5 DATA 091 H 

DCON0 DATA 092H 
DCON1 DATA 093H 
BAUD OATA 094H 

ADRO DATA 095H 



PORT 5 

DMA CONTROL 
DMA CONTROL 1 
GSC BAUD RATE 
GSC MATCH ADDRESS 



I 80C452/83C452 

DCONO DATA 092H 
DCON1 DATA 093H 



DPSEL 



;DMA CONTROL 
;DMA CONTROL 1 



80C517/80C537 — 
DATA 092H 



;DATA POINTER SELECT REGISTER 



SCON DATA 098H .'SERIAL PORT CONTROL 

SBUF DATA 099H .-SERIAL PORT BUFFER 



I 83C751/83C752 — 

I2CON DATA 098H 
I2DAT DATA 099H 



;I2C CONTROL 
;I2C DATA 



I 80C517/80C537 — 

IEN2 DATA 09AH 

S1CON DATA 09BH 
S1BUF DATA 09CH 

S1REL DATA 09DH 



.•INTERRUPT ENABLE REGISTER 2 
SERIAL PORT CONTROL 1 
SERIAL PORT BUFFER 1 
SERIAL RELOAD REG 1 



OSAT 
OSDT 
OSAD 



83C053 
DATA 
DATA 
DATA 



098H 
099H 
09AH 



ON SCREEN ATTRIBUTES 
ON SCREEN DATA 
ON SCREEN ADDRESS 







P2 
IE 



SADDR 



DATA 
DATA 



OAOH 
0A8H 



;PORT 2 

.•INTERRUPT ENABLE 



80C51FA/83C51FA(83C252/80C252) 

DATA 0A9H .-SLAVE INDIVIDUAL ADDRESS 







I 80515/80535 80C517/80C537 

IPO DATA 0A9H .-INTERRUPT PRIORITY REGISTER 



I 80C321/80C521 

WDS DATA 0A9H 

WOK DATA OAAH 



; WATCHDOG SELECTION 
,-WATCHDOG KEY 



I 83C152/80C152 

P6 DATA 0A1H 

SARLO DATA 0A2H 
SARHO DATA 0A3H 
I FS DATA 0A4H 

ADR1 DATA 0A5H 



.-PORT 6 

;DMA SOURCE ADDR. (LOW) 
;DMA SOURCE ADDR. (HIGH) 
;GSC INTERFRAME SPACING 
;GSC MATCH ADDRESS 1 



I 80C452/83C452 — 

SARLO DATA 0A2H 
SARHO DATA 0A3H 



;DMA SOURCE ADDR. (LOW) 
;DMA SOURCE ADDR. (HIGH) 



I 80C552/83C552 — 

CMLO DATA 0A9H 

CML1 DATA OAAH 

CML2 DATA OABH 

CTLO DATA OACH 

CTL1 DATA OADH 

CTL2 DATA OAEH 

CTL3 DATA OAFH 



.■COMPARE 

.•COMPARE 1 

.•COMPARE 2 

.•CAPTURE 

; CAPTURE 1 

; CAPTURE 2 

; CAPTURE 3 



LOW BYTE 
LOW BYTE 
LOW BYTE 
LOW BYTE 
LOW BYTE 
LOW BYTE 
LOW BYTE 



P3 DATA OBOH ;PORT 3 



83C152/80C152 



SARL1 


DATA 


0B2H 


; DMA 


SOURCE ADDR. 1 


(LOW) 


SARH1 


DATA 


0B3H 


; DMA 


SOURCE ADDR. 1 


(HIGH) 


SLOTTM 


DATA 


0B4H 


;GSC 


SLOT TIME 




ADR2 


DATA 


0B5H 


;GSC 


MATCH ADDRESS 


2 



80C452/83C452 

SARL1 DATA 0B2H ;DMA SOURCE ADDR. 1 (LOW) 

SARH1 DATA 0B3H ;DMA SOURCE ADDR. 1 (HIGH) 



IP DATA 0B8H ; INTERRUPT PRIORITY 



SAD EN 



80C51FA/83C51FA(83C252/80C252) 

DATA 0B9H ; SLAVE ADDRESS ENABLE 



80515/80535 80C517/80C537 



IP1 


DATA 


0B9H 


; INTERRUPT PRIORITY REGISTER 1 




IRCON 


DATA 


OCOH 


; INTERRUPT REQUEST CONTROL 




CCEN 


DATA 


0C1H 


.■COMPARE/CAPTURE ENABLE 




CCL1 


DATA 


0C2H 


.•COMPARE/CAPTURE REGISTER 1 - 


LOW BYTE 


CCH1 


DATA 


0C3H 


.■COMPARE/CAPTURE REGISTER 1 - 


HIGH BYTE 


CCL2 


DATA 


0C4H 


.•COMPARE/CAPTURE REGISTER 2 - 


LOW BYTE 


CCH2 


DATA 


0C5H 


.•COMPARE/CAPTURE REGISTER 2 - 


HIGH BYTE 


CCL3 


DATA 


0C6H 


.•COMPARE/CAPTURE REGISTER 3 - 


LOW BYTE 


CCH3 


DATA 


0C7H 


.•COMPARE/CAPTURE REGISTER 3 - 


HIGH BYTE 


T2CON 


DATA 


0C8H 


;TIMER 2 CONTROL 




CRCL 


DATA 


OCAH 


; COMPARE/RELOAD/CAPTURE - LOW 


BYTE 


CRCH 


DATA 


OCBH 


; COMPARE/RELOAD/CAPTURE - HIGH 


BYTE 


TL2 


DATA 


OCCH 


;TIMER 2 - LOW BYTE 




TH2 


DATA 


OCDH 


;TIMER 2 - HIGH BYTE 





CC4EN 

CCL4 

CCH4 



80C517/80C537 

DATA 0C9H 
DATA OCEH 
DATA OCFH 



COMPARE/CAPTURE 4 ENABLE 
COMPARE/CAPTURE REGISTER 4 - LOW BYTE 
COMPARE/CAPTURE REGISTER 4 - HIGH BYTE 



STS 

SMD 

RCB 

RBL 

RBS 

RFL 

STAD 

DMA CNT 



8044/8344 

DATA 0C8H 

DATA 0C9H 

DATA OCAH 

DATA OCBH 

DATA OCCH 

DATA OCDH 

DATA OCEH 

DATA OCFH 



;SIU STATUS REGISTER 
.-SERIAL MODE 
,-RECEIVE CONTROL BYTE 
,-RECEIVE BUFFER LENGTH 
.-RECEIVE BUFFER START 
,-RECEIVE FIELD LENGTH 
.•STATION ADDRESS 
;DMA COUNT 



T2CON 



8052/8032, 80C51FA/83C51FA(83C252/80C252), 80C154/83C154 
DATA 0C8H ; TIMER 2 CONTROL 



T2MOO 



80C51FA/83C51FA(83C252/80C252) 

DATA 0C9H ; TIMER 2 MODE CONTROL 



RCAP2L 
RCAP2H 
TL2 
TH2 



8052/8032, 80C51FA/83C51FA(83C252/80C252), 80C154/83C154 — 
DATA OCAH ;TIMER 2 CAPTURE REGISTER, LOW BYTE 

DATA OCBH ;TIMER 2 CAPTURE REGISTER, HIGH BYTE 

DATA OCCH ; TIMER 2 - LOW BYTE 

DATA OCDH ;TIMER 2 - HIGH BYTE 



83C152/80C152 



P4 


DATA 


OCOH 


PORT 4 


DARLO 


DATA 


0C2H 


DMA DESTINATION ADDR. (LOW) 


DARHO 


DATA 


0C3H 


DMA DESTINATION ADDR. (HIGH) 


BKOFF 


DATA 


0C4H 


GSC BACKOFF TIMER 


ADR3 


DATA 


0C5H 


GSC MATCH ADDRESS 3 


IEN1 


DATA 


0C8H 


INTERRUPT ENABLE REGISTER 1 



P4 

DARLO 
DARHO 



80C452/83C452 

DATA OCOH 
DATA 0C2H 
DATA 0C3H 



;PORT 4 

;DMA DESTINATION ADDR. (LOW) 
;DMA DESTINATION ADDR. (HIGH) 



80C451/83C451 

P4 DATA OCOH ;PORT 4 

P5 DATA OC8H ;PORT 5 



IRCON 



80512/80532 

DATA OCOH 



; INTERRUPT REQUEST CONTROL 



80C552/83C552 



P4 
P5 

AD CON 

ADCH 

TM2IR 

CMHO 

CMH1 

CMH2 

CTHO 

CTH1 

CTH2 

CTH3 



DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 



OCOH 
0C4H 
0C5H 
0C6H 
0C8H 
0C9H 
OCAH 
OCBH 
OCCH 
OCDH 
OCEH 
OCFH 



PORT 4 
PORT 5 

A/D CONVERTER CONTROL 
A/D CONVERTER HIGH BYTE 
T2 INTERRUPT FLAGS 



COMPARE 
COMPARE 1 
COMPARE 
CAPTURE 
CAPTURE 
CAPTURE 
CAPTURE 



HIGH BYTE 
HIGH BYTE 
HIGH BYTE 
HIGH BYTE 
HIGH BYTE 
HIGH BYTE 
HIGH BYTE 



OSCON 
OSMOD 
OSORG 



83C053 
DATA 
DATA 
DATA 



OCOH ;ON SCREEN DISPLAY CONTROL 
0C1H ;ON SCREEN DISPLAY MODE 
0C2H ;ON SCREEN DISPLAY ORIGIN 




PSU 



DATA 



8044/8344 



ODOH 



; PROGRAM STATUS WORD 



NSNR 


DATA 


0D8H 


;SEND COUNT/RECEIVE COUNT 


S1UST 


DATA 


0D9H 


;SIU STATE COUNTER 


TCB 


DATA 


ODAH 


; TRANSMIT CONTROL BYTE 


TBL 


DATA 


ODBH 


.•TRANSMIT BUFFER LENGTH 


TBS 


DATA 


ODCH 


.•TRANSMIT BUFFER START 


FIFOO 


DATA 


ODDH 


; THREE BYTE FIFO 


FIF01 


DATA 


ODEH 




FIF02 


DATA 


ODFH 





80C51FA/83C51FAC83C252/80C252) 







CCON 


DATA 


0D8H 


.•CONTROL COUNTER 


CMOO 


DATA 


0D9H 


.•COUNTER MODE 


CCAPMO 


DATA 


ODAH 


.•COMPARE/CAPTURE MODE FOR PCA MODULE 


CCAPM1 


DATA 


ODBH 


.•COMPARE/CAPTURE MODE FOR PCA MODULE 1 


CCAPM2 


DATA 


ODCH 


/COMPARE/CAPTURE MODE FOR PCA MODULE 2 


CCAPM3 


DATA 


ODDH 


; COMPARE/CAPTURE MODE FOR PCA MODULE 3 


CCAPM4 


DATA 


ODEH 


.■COMPARE/CAPTURE MODE FOR PCA MODULE 4 



AD CON 
ADDAT 
DAPR 



80515/80535 

DATA 0D8H 



DATA 



ODAH 



;A/D CONVERTER CONTROL 

;A/D CONVERTER DATA 

;D/A CONVERTER PROGRAM REGISTER 



83C152/80C152 

DARL1 DATA 0D2H 
DARH1 DATA 0D3H 
TCDCNT DATA 0D4H 
AMSKO DATA 0D5H 
TSTAT DATA 0D8H 



DARL1 
DARH1 



80C452/83C452 

DATA 0D2H 
DATA 0D3H 



;DMA DESTINATION ADDR. 1 (LOW) 
;DMA DESTINATION ADDR. 1 (HIGH) 
;GSC TRANSMIT COLLISION COUNTER 
;GSC ADDRESS MASK 
.•TRANSMIT STATUS (DMA & GSC) 








;DMA DESTINATION ADDR. 1 (LOW) 
;DMA DESTINATION ADDR. 1 (HIGH) 




80C451/83C451 

P6 DATA 0D8H 



;PORT 6 



80512/80532 

ADCON DATA 0D8H 
ADDAT DATA 0D9H 
DAPR DATA ODAH 

P6 DATA ODBH 





;A/D CONVERTER CONTROL 

;A/D CONVERTER DATA 

;D/A CONVERTER PROGRAM REGISTER 

.-PORT 6 



I2CFG 



83C751/83C752 — 
DATA 0D8H 



;I2C CONFIGURATION 



S1CON 
S1STA 
S1DAT 
S1ADR 



80C552/83C552, 80C652/83C652 

DATA 0D8H ; SERIAL 1 CONTROL 

DATA 0D9H ; SERIAL 1 STATUS 

DATA ODAH ; SERIAL 1 DATA 

DATA ODBH ;SERIAL 1 SLAVE ADDRESS 



CMLO 

CMHO 

CML1 

CMH1 

CML2 

CMH2 

ADCONO 

ADDAT 

DAPR 

P7 

AD CON 1 
P8 

CTRELL 
CTRELH 



80C517/80C537 



DATA 0D2H ; COMPARE REGISTER - LOU BYTE 

DATA 0D3H ; COMPARE REGISTER - HIGH BYTE 

DATA 0D4H ; COMPARE REGISTER 1 - LOW BYTE 

DATA 0D5H .-COMPARE REGISTER 1 - HIGH BYTE 

DATA 0D6H ; COMPARE REGISTER 2 - LOU BYTE 

DATA 0D7H .-COMPARE REGISTER 2 - HIGH BYTE 

DATA 0D8H ;A/D CONVERTER CONTROL 

DATA 0D9H ;A/D CONVERTER DATA 

DATA ODAH ;D/A CONVERTER PROGRAM REGISTER 

DATA ODBH ;PORT 7 

DATA ODCH ;A/D CONVERTER CONTROL 1 

DATA ODDH ;PORT 8 

DATA ODEH ;COM TIMER REL REG - LOW BYTE 

DATA ODFH ;COM TIMER REL REG - HIGH BYTE 



TDACL 

TDACH 

PUMO 

PUM1 

PUM2 

PUM3 

SAD 

PWM4 

PWM5 

PUM6 

PUM7 



83C053 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 



0D2H 
0D3H 
0D4H 
0D5H 
0D6H 
0D7H 
0D8H 
ODCH 
ODDH 
ODEH 
ODFH 



HI -RES PULSE WIDTH MODULATOR 
HI -RES PULSE WIDTH MODULATOR 
LO-RES PULSE WIDTH MODULATOR 
LO-RES PULSE WIDTH MODULATOR 1 
LO-RES PULSE WIDTH MODULATOR 2 
LO-RES PULSE WIDTH MODULATOR 3 
D/A AND VOLTAGE COMPARATOR 
LO-RES PULSE WIDTH MODULATOR 4 
LO-RES PULSE WIDTH MODULATOR 5 
LO-RES PULSE WIDTH MODULATOR 6 
LO-RES PULSE WIDTH MODULATOR 7 



ACC 



BCRLO 

BCRHO 

PRBS 

AMSK1 

RSTAT 



DATA 



OEOH 



83C152/80C152 

DATA 0E2H 
DATA 0E3H 
DATA 0E4H 
DATA 0E5H 
DATA 0E8H 



; ACCUMULATOR 



DMA BYTE COUNT (LOW) 
DMA BYTE COUNT (HIGH) 
GSC PSEUDO- RANDOM SEQUENCE 
GSC ADDRESS MASK 1 
RECEIVE STATUS (DMA & GSC) 



80C452/83C452 



BCRLO 


DATA 


0E2H 


DMA BYTE COUNT (LOW) 


BCRHO 


DATA 


0E3H 


DMA BYTE COUNT (HIGH) 


HSTAT 


DATA 


0E6H 


HOST STATUS 


HCON 


DATA 


0E7H 


HOST CONTROL 


SLCON 


DATA 


0E8H 


SLAVE CONTROL 


SSTAT 


DATA 


0E9H 


SLAVE STATUS 


IWPR 


DATA 


OEAH 


INPUT WRITE POINTER 


IRPR 


DATA 


OEBH 


INPUT READ POINTER 


CBP 


DATA 


OECH 


CHANNEL BOUNDARY POINTER 


FIN 


DATA 


OEEH 


FIFO IN 


CIN 


DATA 


OEFH 


COMMAND IN 



P4 



80515/80535 

DATA 0E8H 



.-PORT 4 



CSR 



80C451/83C451 — 
DATA 0E8H 



; CONTROL STATUS 



80512/80532 

P4 DATA 0E8H ;PORT 4 



80C552/83C552 



IEN1 


DATA 


0E8H 


INTERRUPT ENABLE REGISTER 1 


TM2C0N 


DATA 


OEAH 


T2 COUNTER CONTROL 


CTCON 


DATA 


OEBH 


CAPTURE CONTROL 


TML2 


DATA 


OECH 


TIMER 2 - LOW BYTE 


TMH2 


DATA 


OEDH 


TIMER 2 - HIGH BYTE 


STE 


DATA 


OEEH 


SET ENABLE 


RTE 


DATA 


OEFH ; RESET/TOGGLE ENABLE 



80C51 FA/83C51 FA(83C252/80C262) 



CL 


DATA 


0E9H 


.•CAPTURE BYTE LOW 


CCAPOL 


DATA 


OEAH 


; COMPARE/CAPTURE LOW BYTE 


CCAP1L 


DATA 


OEBH 


; COMPARE/CAPTURE 1 LOW BYTE 


CCAP2L 


DATA 


OECH 


; COMPARE/CAPTURE 2 LOW BYTE 


CCAP3L 


DATA 


OEDH 


.■COMPARE/CAPTURE 3 LOW BYTE 


CCAP4L 


DATA 


OEEH 


.•COMPARE/CAPTURE 4 LOW BYTE 



— 



80C517/80C537 



CTCON 


DATA 


OE1H 


;COM TIMER CONTROL REG 






CML3 


DATA 


0E2H 


; COMPARE REGISTER 3 - 


LOW BYTE 




CMH3 


DATA 


0E3H 


.•COMPARE REGISTER 3 - 


HIGH BYTE 




CML4 


DATA 


0E4H 


.•COMPARE REGISTER 4 - 


LOW BYTE 




CMH4 


DATA 


0E5H 


.•COMPARE REGISTER 4 - 


HIGH BYTE 




CML5 


DATA 


0E6H 


.■COMPARE REGISTER 5 - 


LOW BYTE 




CMH5 


DATA 


0E7H 


.•COMPARE REGISTER 5 - 


HIGH BYTE 


P4 


HAT A 

UA 1 A 


uton 


;PORT 4 






MDO 


DATA 


0E9H 


;MUL/DIV REG 






MD1 


DATA 


OEAH 


,-MUL/DIV REG 1 






MD2 


DATA 


OEBH 


;MUL/DIV REG 2 






MD3 


DATA 


OECH 


;MUL/DIV REG 3 






MD4 


DATA 


OEDH 


;MUL/DIV REG 4 






M05 


DATA 


OEEH 


;MUL/DIV REG 5 






ARCON 


DATA 


OEFH 


.•ARITHMETIC CONTROL REG 





: 



B DATA OFOH .-MULTIPLICATION REGISTER 

80C154/83C154 

IOCON DATA 0F8H ;I/0 CONTROL REGISTER 




83C152/80C152 



BCRL1 


DATA 


0F2H 


;DMA BYTE COUNT 1 (LOW) 




BCRH1 


DATA 


0F3H 


;DMA BYTE COUNT 1 (HIGH) 




RFIFO 


DATA 


0F4H 


;GSC RECEIVE BUFFER 




MYSLOT 


DATA 


0F5H 


;GSC SLOT ADDRESS 




IPN1 


DATA 


0F8H 


; INTERRUPT PRIORITY REGISTER 


1 







80C452/83C452 



BCRL1 


DATA 


0F2H 


DMA BYTE COUNT 1 (LOW) 


BCRH1 


DATA 


0F3H 


DMA BYTE COUNT 1 (HIGH) 


ITHR 


DATA 


0F6H 


INPUT FIFO THRESHOLD 


OTHR 


DATA 


0F7H 


OUTPUT FIFO THRESHOLD 


IEP 


DATA 


0F8H 


INTERRUPT PRIORITY 


MODE 


DATA 


0F9H 


MODE 


ORPR 


DATA 


OFAH 


OUTPUT READ POINTER 


OWPR 


DATA 


OFBH 


OUTPUT WRITE POINTER 


IMIN 


DATA 


OFCH 


IMMEDIATE COMMAND IN 


IMOUT 


DATA 


OFDH 


IMMEDIATE COMMAND OUT 


FOUT 


DATA 


OFEH 


FIFO OUT 


COUT 


DATA 


OFFH 


COMMAND OUT 



oniric /oncic 


P5 


DATA 0F8H 


;PORT 5 




oncn /oncn 


P5 


DATA 0F8H 


;PORT 5 






I2STA 


DATA 0F8H 


;I2C STATUS 





80C552/83C552 

IP1 DATA 0F8H ; INTERRUPT PRIORITY REGISTER 1 

PUMO DATA OFCH ;PULSE UIDTH REGISTER 

PWM1 DATA OFDH ;PULSE UIDTH REGISTER 1 

PWMP DATA OFEH ;PRESCALER FREQUENCY CONTROL 

T3 DATA OFFH ;T3 - WATCHDOG TIMER 



80C517/80C537 

CML6 DATA 0F2H .-COMPARE REGISTER 6 - LOU BYTE 

CMH6 DATA 0F3H ; COMPARE REGISTER 6 - HIGH BYTE 

CML7 DATA 0F4H .-COMPARE REGISTER 7 - LOU BYTE 

CMH7 DATA 0F5H ; COMPARE REGISTER 7 - HIGH BYTE 

CMEN DATA 0F6H ; COMPARE ENABLE 

CMSEL DATA 0F7H .-COMPARE INPUT REGISTER 

P5 DATA 0F8H ;PORT 5 

P6 DATA OFAH ;PORT 6 



80C51FA/83C51FAC83C252/80C252) 

CH DATA 0F9H ; CAPTURE HIGH BYTE 

CCAPOH DATA OFAH ; COMPARE/CAPTURE HIGH BYTE 

CCAP1H DATA OFBH ; COMPARE/CAPTURE 1 HIGH BYTE 

CCAP2H DATA OFCH ; COMPARE/CAPTURE 2 HIGH BYTE 

CCAP3H DATA OFDH ; COMPARE/CAPTURE 3 HIGH BYTE 

CCAP4H DATA OFEH ; COMPARE/CAPTURE 4 HIGH BYTE 



83C752 

PUENA DATA OFEH ;PULSE UIDTH ENABLE 



80C851/83C851 

EADRL DATA 0F2H ;EEPROM ADDRESS REGISTER - LOU BYTE 

EADRH DATA 0F3H ;EEPROM ADDRESS REGISTER - HIGH BYTE 

EDAT DATA 0F4H ;EEPROM DATA REGISTER 

ETIM DATA 0F5H ;EEPROM TIMER REGISTER 

ECNTRL DATA 0F6H ;EEPROM CONTROL REGISTER 



Predefined Bit Addresses 



- 



83C751/83C752 

SCL BIT 080H ;P0.0 - I2C SERIAL CLOCK 

SDA BIT 081H ;P0.1 - I2C SERIAL DATA 



ITO 


BIT 


088H 


TCON.O - 


EXT. INTERRUPT TYPE 


IEO 


BIT 


089H 


TC0N.1 - 


EXT. INTERRUPT EDGE FLAG 


IT1 


BIT 


08AH , 


TC0N.2 - 


EXT. INTERRUPT 1 TYPE 


IE1 


BIT 


08BH 


TC0N.3 - 


EXT. INTERRUPT 1 EDGE FLAG 


TRO 


BIT 


08CH 


TC0N.4 - 


TIMER ON/OFF CONTROL 


TFO 


BIT 


080 H 


TC0N.5 - 


TIMER OVERFLOW FLAG 


TR1 


BIT 


08EH 


TC0N.6 - 


TIMER 1 ON/OFF CONTROL 


TF1 


BIT 


08FH 


TC0N.7 - 


TIMER 1 OVERFLOW FLAG 



83C751/83C752 

C/T BIT 08EH ;TC0N.6 - COUNTER OR TIMER OPERATION 

GATE BIT 08FH ;TC0N.7 - GATE TIMER 



80515/80535 



INT3 


BIT 


090H 


P1 


.0 - 


EXT. INTERRUPT 3/CAPT & COMP 


INT4 


BIT 


091 H 


P1 


.1 - 


EXT. INTERRUPT 4/CAPT & COMP 1 


INT5 


BIT 


092H 


P1 


.2 - 


EXT. INTERRUPT 5/CAPT & COMP 2 


INT6 


BIT 


093H 


P1 


.3 - 


EXT. INTERRUPT 6/CAPT & COMP 3 


INT2 


BIT 


094 H 


P1 


.4 - 


EXT. INTERRUPT 2 


T2EX 


BIT 


095H 


P1 


.5 - 


TIMER 2 EXT. RELOAD TRIGGER INP 


CLKOUT 


BIT 


096H 


P1 


.6 - 


SYSTEM CLOCK OUTPUT 


T2 


BIT 


097H 


PI 


.7 - 


TIMER 2 INPUT 



83C152/80C152 



GRXD 


BIT 


090H 


;P1.0 - 


GSC RECEIVER DATA INPUT 


GTXD 


BIT 


091 H 


;P1.1 - 


GSC TRANSMITTER DATA OUTPUT 


DEN 


BIT 


092H 


;P1.2 - 


DRIVE ENABLE TO ENABLE EXT DRIVER 


TXC 


BIT 


093H 


;P1.3 - 


GSC EXTERNAL TRANSMIT CLOCK INPUT 


RXC 


BIT 


094H 


;P1.4 - 


GSC EXTERNAL RECEIVER CLOCK INPUT 



83C552/80C552 



CTOI 


BIT 


090 H 


P1.0 - 


CAPTURE/TIMER INPUT 


CT1I 


BIT 


091 H 


P1.1 - 


CAPTURE/TIMER INPUT 1 


CT2I 


BIT 


092H 


P1.2 - 


CAPTURE/TIMER INPUT 2 


CT3I 


BIT 


093H 


P1.3 - 


CAPTURE/TIMER INPUT 3 


T2 


8IT 


094 H 


P1.4 - 


T2 EVENT INPUT 


RT2 


BIT 


095H 


P1.5 - 


T2 TIMER RESET SIGNAL 


SCL 


BIT 


096H 


P1.6 - 


SERIAL PORT CLOCK LINE I2C 


SDA 


BIT 


097H 


P1.7 - 


SERIAL PORT DATA LINE I2C 



80C517/80C537 



INT3 


BIT 


090H 


;P1.0 - 


EXT. INTERRUPT 3/CAPT & COMP 


INT4 


BIT 


091 H 


;P1.1 - 


EXT. INTERRUPT 4/CAPT & COMP 1 


INT5 


BIT 


092H 


;P1.2 - 


EXT. INTERRUPT 5/CAPT & COMP 2 


INT6 


BIT 


093H 


;P1.3 - 


EXT. INTERRUPT 6/CAPT & COMP 3 


INT2 


BIT 


094H 


;P1.4 - 


EXT. INTERRUPT 2 


T2EX 


BIT 


095H 


;P1.5 - 


TIMER 2 EXT. RELOAD TRIGGER INPUT 


CLKOUT 


BIT 


096H 


;P1.6 - 


SYSTEM CLOCK OUTPUT 


T2 


BIT 


097H 


;P1.7 - 


TIMER 2 INPUT 



80C452/83C452, 80C152/83C152 

HLD BIT 095H ;P1.5 - DMA HOLD REQUEST I/O 

HLDA BIT 096H ;P1.6 - DMA HOLD ACKNOWLEDGE OUTPUT 



83C751/83C752 

INTO BIT 095H ;P1.5 - EXTERNAL INTERRUPT INPUT 

INT1 BIT 096H ;P1.6 - EXTERNAL INTERRUPT 1 INPUT 

TO BIT 096H ;P1.7 - TIMER COUNT INPUT 



RI 


BIT 


098H 


;SCON.0 - 


RECEIVE INTERRUPT FLAG 


TI 


BIT 


099H 


;SCON.1 - 


TRANSMIT INTERRUPT FLAG 


RB8 


BIT 


09AH 


; SCON. 2 - 


RECEIVE BIT 8 


TB8 


BIT 


09BH 


; SCON. 3 - 


TRANSMIT BIT 8 


REN 


BIT 


09CH 


; SCON. 4 - 


RECEIVE ENABLE 


SM2 


BIT 


09DH 


; SCON. 5 - 


SERIAL MODE CONTROL BIT 2 


SM1 


BIT 


09EH 


; SCON. 6 - 


SERIAL MODE CONTROL BIT 1 



SMO 



BIT 09FH 



;SC0N.7 - SERIAL MODE CONTROL BIT 



83C751/83C752 



MASTER 


BIT(READ) 099H j 


I2CON.1 


_ 


MASTER 




STP 


B I T ( READ ) 09AH 


I2CON.2 




STOP 




STR 


BIT(REAO) 09BH , 


I2CON.3 


_ 


START 




ARL 


BIT(READ) 09CH , 


I2CON.4 




ARBITRATION LOSS 




DRDY 


BIT(READ) 090H 


I2CON.5 




DATA READY 




ATN 


BIT(READ) 09EH 


I2CON.6 




ATTENTION 




RDAT 


BIT (READ) 09FH 


I2CON.7 




RECEIVE DATA 




XSTP 


BIT(URITE)098H 


I2CON.0 




TRANSMIT STOP 




XSTR 


BIT(WRITE)099H 


I2CON.1 




TRANSMIT REPEATED 


START 


CSTP 


BIT(URITE)09AH 


I2CON.2 




CLEAR STOP 




CSTR 


BIT(WRITE)09BH 


I2CON.3 




CLEAR START 




CARL 


BIT(URITE)09CH 


I2CON.4 




CLEAR ARBITRATION 


LOSS 


CDR 


BIT(URITE)09DH 


I2CON.5 




CLEAR DATA READY 




IDLE 


BIT(WRITE)09EH 


I2CON.6 




GO IDLE 




CXA 


BIT(WRITE)09FH 


I2CON.7 




CLEAR TRANSMIT ACTIVE 















ADIO 


BIT 


090H 


;P1.0 - 


SOFTWARE A/D INPUT 


ADI1 


BIT 


091 H 


;P1.1 - 


SOFTWARE A/D INPUT 1 


ADI2 


BIT 


092H 


;P1.2 - 


SOFTWARE A/D INPUT 2 


ASATO 


BIT 


098H 


;OSAT.O 


- MULTIPLE FUNCTION (DEPENDS ON OSDT) 


ASAT1 


BIT 


099H 


;OSAT.1 


- MULTIPLE FUNCTION (DEPENDS ON OSDT) 


ASAT2 


BIT 


09AH 


;OSAT.2 


- MULTIPLE FUNCTION (DEPENDS ON OSDT) 


ASAT3 


BIT 


09BH 


;OSAT.3 




ASAT4 


BIT 


09CH 


;OSAT.4 


- SHOW BACKGROUND / SHOW FURTHER ROWS 


ASAT5 


BIT 


09DH 


;OSAT.5 




ASAT6 


BIT 


09EH 


;OSAT.6 




ASAT7 


BIT 


09FH 


;OSAT.7 





EXO 


BIT 


0A8H 


;IE.O 


- EXTERNAL INTERRUPT ENABLE 


ETO 


BIT 


0A9H 


;IE.1 


- TIMER INTERRUPT ENABLE 


EX1 


BIT 


OAAH 


;IE.2 


- EXTERNAL INTERRUPT 1 ENABLE 


ET1 


BIT 


OABH 


;IE.3 


- TIMER 1 INTERRUPT ENABLE 


ES 


BIT 


OACH 


;IE.4 


- SERIAL PORT INTERRUPT ENABLE 



83C751/83C752 

EI2 BIT OACH ;IE.4 - SERIAL PORT INTERRUPT ENABLE 



83C053 

EVS BIT OACH ;IE.4 - VSYNC INTERRUPT ENABLE 



8052/8032, 80C154/83C154, 80C252(80C51FA), 80515/80535 

ET2 BIT OADH /TIMER 2 INTERRUPT ENABLE 



80C652/83C652 

ES1 BIT OADH ; I E . 5 - SERIAL PORT 1 INTERRUPT ENABLE 



80C252(80C51FA) 

EC BIT OAEH ;IE.6 - ENABLE PCA INTERRUPT 



80515/80535 

WDT BIT OAEH ; IEN0 .6 - WATCHDOG TIMER RESET 



83C552/80C552 

ES1 BIT OADH ;IEN0.5 - SERIAL PORT 1 INTERRUPT ENABLE 

EAD BIT OAEH ;IEN0.6 - ENABLE A/D INTERRUPT 



80C517/80C537 

ET2 BIT OADH ;IEN0.5 - TIMER 2 INTERRUPT ENABLE 

WDT BIT OAEH ;IEN0.6 - WATCHDOG TIMER RESET 



EA 


BIT 


OAFH 


IE. 7 - 


GLOBAL INTERRUPT ENABLE 


RXD 


BIT 


OBOH 


P3.0 - 


SERIAL PORT RECEIVE INPUT 


TXD 


BIT 


0B1H 


P3.1 - 


SERIAL PORT TRANSMIT OUTPUT 


INTO 


BIT 


0B2H 


P3.2 - 


EXTERNAL INTERRUPT INPUT 


INT1 


BIT 


0B3H 


P3.3 - 


EXTERNAL INTERRUPT 1 INPUT 


TO 


BIT 


0B4H 


P3.4 - 


TIMER COUNT INPUT 


T1 


BIT 


0B5H 


P3.5 - 


TIMER 1 COUNT INPUT 


WR 


BIT 


0B6H 


P3.6 - 


WRITE CONTROL FOR EXT. MEMORY 


RD 


BIT 


0B7H 


P3.7 - 


READ CONTROL FOR EXT. MEMORY 



PXO 


BIT 


OB8H 


;IP.O - 


EXTERNAL INTERRUPT 


PRIORITY 


PTO 


BIT 


0B9H 


;IP.1 - 


TIMER PRIORITY 




PX1 


BIT 


OBAH 


;IP.2 - 


EXTERNAL INTERRUPT 1 


PRIORITY 


PT1 


BIT 


OBBH 


;IP.3 - 


TIMER 1 PRIORITY 




PS 


BIT 


OBCH 


;IP.4 - 


SERIAL PORT PRIORITY 





80C154/83C154 

PT2 BIT OBCH ;IP.5 - TIMER 2 PRIORITY 

PCT BIT OBFH ;IP.7 - INTERRUPT PRIORITY DISABLE 




80C652/83C652 

BIT OBDH ;IP.5 - SERIAL PORT 1 PRIORITY 



80C51FA/83C51FA(83C252/80C252) 

PT2 BIT OBDH ;IP.5 - TIMER 2 PRIORITY 

PPC BIT OBEH ;IP.6 - PCA PRIORITY 

80515/80535, 80C517/80C537 



EADC 


BIT 


0B8H ;IEN1.0 - 


A/D CONVERTER INTERRUPT ENABLE 


EX2 


BIT 


0B9H 


IEN1.1 - 


EXT. INTERRUPT 2 ENABLE 


EX3 


BIT 


OBAH , 


IEN1.2 - 


EXT. INT 3/CAPT/C0MP INT EN 


EX4 


BIT 


OBBH 


IEN1.3 - 


EXT. INT 4/CAPT/C0MP INT 1 EN 


EX5 


BIT 


OBCH 


IEN1.4 - 


EXT. INT 5/CAPT/C0MP INT 2 EN 


EX6 


BIT 


OBDH 


IEN1.5 - 


EXT. INT 6/CAPT/COMP INT 3 EN 


SUDT 


BIT 


OBEH 


IEN1.6 - 


WATCHDOG TIMER START 


EXEN2 


BIT 


OBFH 


IEN1.7 - 


T2 EXT. RELOAD INTER START 


I ADC 


BIT 


OCOH 


IRCON.O 


- A/D CONVERTER INTER REQUEST 


IEX2 


BIT 


0C1H 


IRC0N.1 


- EXT. INTERRUPT 2 EDGE FLAG 


IEX3 


BIT 


0C2H 


IRC0N.2 


- EXT. INTERRUPT 3 EDGE FLAG 


IEX4 


BIT 


0C3H 


IRC0N.3 


- EXT. INTERRUPT 4 EDGE FLAG 


IEX5 


BIT 


0C4H 


IRC0N.4 


- EXT. INTERRUPT 5 EDGE FLAG 


IEX6 


BIT 


0C5H 


IRC0N.5 


- EXT. INTERRUPT 6 EDGE FLAG 


TF2 


BIT 


0C6H 


IRC0N.6 


- TIMER 2 OVERFLOU FLAG 


EXF2 


BIT 


0C7H 


IRC0N.7 


- TIMER 2 EXT. RELOAD FLAG 


T2I0 


BIT 


0C8H 


T2CON.0 


- TIMER 2 INPUT SELECT BIT 


T2I1 


BIT 


0C9H 


T2C0N.1 


- TIMER 2 INPUT SELECT BIT 1 


T2CM 


BIT 


OCAH 


T2C0N.2 


- COMPARE MODE 


T2R0 


BIT 


OCBH 


T2CON.3 


- TIMER 2 RELOAD MODE SEL BIT 


T2R1 


BIT 


OCCH 


T2C0N.4 


- TIMER 2 RELOAD MODE SEL BIT 1 


I2FR 


BIT 


OCDH 


T2CON.5 


- EXT. INT 2 F/R EDGE FLAG 


13FR 


BIT 


OCEH , 


T2C0N.6 


- EXT. INT 3 F/R EDGE FLAG 


T2PS 


BIT 


OCFH 


T2C0N.7 


- PRESCALER SELECT BIT 



80C552/83C552 



PS1 


BIT 


OBDH 


IPO. 5 


- SI01 


PAD 


BIT 


OBEH 


IPO. 6 


- A/D CONVERTER 


CMSRO 


BIT 


OCOH 


P4.0 


- T2 


COMPARE AND SET/RESET OUTPUTS 


CMSR1 


BIT 


0C1H 


P4.1 


- T2 


COMPARE AND SET/RESET OUTPUTS 


CMSR2 


BIT 


0C2H 


P4.2 


- T2 


COMPARE AND SET/RESET OUTPUTS 


CMSR3 


BIT 


0C3H 


P4.3 


- T2 


COMPARE AND SET/RESET OUTPUTS 


CMSR4 


BIT 


0C4H 


P4.4 


- T2 


COMPARE AND SET/RESET OUTPUTS 


CMSR5 


BIT 


0C5H 


P4.5 


- T2 


COMPARE AND SET/RESET OUTPUTS 


CMTO 


BIT 


0C6H 


P4.6 


- T2 


COMPARE AND TOGGLE OUTPUTS 


CMT1 


BIT 


0C7H 


P4.7 


- T2 


COMPARE AND TOGGLE OUTPUTS 


CTIO 


BIT 


0C8H 


TM2IR 


.0 - 


T2 CAPTURE 


CTI1 


BIT 


0C9H 


TM2IR 


.1 - 


T2 CAPTURE 1 


CTI2 


BIT 


OCAH , 


TM2IR 


.2 - 


T2 CAPTURE 2 


CTI3 


BIT 


OCBH 


TM2IR 


.3 - 


T2 CAPTURE 3 


CMIO 


BIT 


OCCH 


TM2IR 


.4 - 


T2 COMPARATOR 


CMI1 


BIT 


OCDH 


TM2IR 


.5 - 


T2 COMPARATOR 1 


CMI2 


BIT 


OCEH 


TM2IR 


.6 - 


T2 COMPARATOR 2 


T20V 


BIT 


OCFH 


TM2IR 


.7 - 


T2 OVERFLOW 



8044/8344 



RBP 


BIT 


0C8H 


STS 


- 


RECEIVE BUFFER PROTECT 


AM 


BIT 


0C9H 


■STS 


1 - 


AUTO/ADDRESSED MODE SELECT 


OPB 


BIT 


OCAH 


STS 


2 - 


OPTIONAL POLL BIT 


BOV 


BIT 


OCBH 


STS 


3 - 


RECEIVE BUFFER OVERRUN 


SI 


BIT 


OCCH 


STS 


4 - 


SIU INTERRUPT FLAG 


RTS 


BIT 


OCDH 


STS 


5 - 


REQUEST TO SEND 


RBE 


BIT 


OCEH 


STS 


6 - 


RECEIVE BUFFER EMPTY 


TBF 


BIT 


OCFH 


STS 


7 - 


TRANSMIT BUFFER FULL 



8052/8032, 80C154/83C154, 80C51 FA/83C51 FA(80C252/83C252> 



CAP2 


BIT 


0C8H , 


T2CON.0 - 


CAPTURE OR RELOAD SELECT 


CNT2 


BIT 


0C9H 


T2C0N.1 - 


TIMER OR COUNTER SELECT 


TR2 


BIT 


OCAH 


T2C0N.2 - 


TIMER 2 ON/OFF CONTROL 


EXEN2 


BIT 


OCBH 


T2C0M.3 - 


TIMER 2 EXTERNAL ENABLE FLAG 


TCLK 


BIT 


OCCH 


T2C0N.4 - 


TRANSMIT CLOCK SELECT 


RCLK 


BIT 


OCDH 


T2CON.5 - 


RECEIVE CLOCK SELECT 


EXF2 


BIT 


OCEH 


T2C0N.6 - 


EXTERNAL TRANSITION FLAG 


TF2 


BIT 


OCFH 


T2C0N.7 - 


TIMER 2 OVERFLOW FLAG 



80C152/83C152 



EGSRV 


BIT 


0C8H 


IEN1 


.0 - 


GSC 


RECEIVE VALID 




EGSRE 


BIT 


0C9H 


IEN1 


.1 - 


GSC 


RECEIVE ERROR 




EDMAO 


BIT 


OCAH 


IEN1 


.2 - 


DMA 


CHANNEL REQUEST 





EGSTV 


BIT 


OCBH 


IEN1 


.3 - 


GSC 


TRANSMIT VALID 




EDMA1 


BIT 


OCCH 


IEN1 


.4 - 


DMA 


CHANNEL REQUEST 


1 


EGSTE 


BIT 


OCDH 


IEN1 


.5 - 


GSC 


TRANSMIT ERROR 





80512/80532 

IADC BIT OCOH ;IRCON.O - A/D CONVERTER INTERRUPT REQ 



83C053 



BFE 


BIT 


OCOH 


OSCON 


- 


BF PIN ENABLE 


DH 


BIT 


0C1H 


OSCON 


1 - 


DOUBLE HEIGHT 


PO 


BIT 


0C2H 


OSCON 


.2 - 


SHADOWING LOW/HIGH CONTROL 


PC 


BIT 


0C3H 


OSCON 


3 - 


LOW / HIGH ON VCTRL (COLOR VI D2 


PH 


BIT 


0C4H 


OSCON 


4 - 


HSYNC INPUT ACTIVE LOW /HIGH 


LV 


BIT 


0C5H 


OSCON 


5 - 


VSYNC LEADING / TRAILING EDGE 


PV 


BIT 


0C6H 


OSCON 


6 - 


VSYNC ACTIVE LOW /HIGH 


IV 


BIT 


0C7H 


OSCON 


7 - 


VSYNC INTERRUPT FLAG 



P BIT ODOH ;PSW.O - ACCUMULATOR PARITY FLAG 

80C552/83C552 

F1 BIT 0D1H ;PSW.1 - FLAG 1 



80512/80532 

F1 BIT 0D1H 

MXO BIT 0D8H 

MX1 BIT 0D9H 

MX 2 BIT ODAH 

ADM BIT ODBH 

BSY BIT ODCH 

BD BIT ODFH 



PSW.1 - FLAG 1 

ADCON.O - ANALOG INPUT CH SELECT BIT 

ADCON.1 - ANALOG INPUT CH SELECT BIT 1 

AD CON. 2 - ANALOG INPUT CH SELECT BIT 2 

ADCON.3 - A/D CONVERSION MODE 

AD CON. 4 - BUSY FLAG 

AD CON. 7 - BAUD RATE ENABLE 



OV 


BIT 


0D2H 


;PSW.2 


- OVERFLOW FLAG 


RSO 


BIT 


0D3H 


;PSW.3 


- REGISTER BANK SELECT 


RS1 


BIT 


0D4H 


;PSW.4 


- REGISTER BANK SELECT 1 


FO 


BIT 


0D5H 


;PSW.5 


- FLAG 


AC 


BIT 


0D6H 


;PSW.6 


- AUXILIARY CARRY FLAG 


CY 


BIT 


0D7H 


;PSW.7 


- CARRY FLAG 



80C41 FA/83C51 FA(80C252/83C252) 



CCFO 


BIT 


0D8H 


;CCON.O -PCA MODULE 


INTERRUPT 


FLAG 


CCF1 


BIT 


0D9H 


;CCON.1 -PCA MODULE 1 


INTERRUPT 


FLAG 


CCF2 


BIT 


ODAH 


;CCON.2 -PCA MODULE 2 


INTERRUPT 


FLAG 


CCF3 


BIT 


ODBH 


;CC0N.3 -PCA MODULE 3 


INTERRUPT 


FLAG 


CCF4 


BIT 


ODCH 


;CC0N.4 -PCA MODULE 4 


INTERRUPT 


FLAG 


CR 


BIT 


ODEH 


;CC0N.6 - COUNTER RUN 






CF 


BIT 


ODFH 


;PCA COUNTER OVERFLOW 


FLAG 





8044/8344 



SER 


BIT 


0D8H 


;NSNR.O - 


RECEIVE SEQUENCE ERROR 




NRO 


BIT 


0D9H 


;NSNR.1 - 
;NSNR.2 - 


RECEIVE SEQUENCE COUNTER-BIT 





NR1 


BIT 


ODAH 


RECEIVE SEQUENCE COUNTER-BIT 


1 


NR2 


BIT 


ODBH 


;NSNR.3 - 


RECEIVE SEQUENCE COUNTER-BIT 


2 


SES 


BIT 


ODCH 


;NSNR.4 - 


SEND SEQUENCE ERROR 




NSO 


BIT 


ODDH 


;NSNR.5 - 


SEND SEQUENCE COUNTER-BIT 




NS1 


BIT 


ODEH 


;NSNR.6 - 


SEND SEQUENCE COUNTER-BIT 1 




NS2 


BIT 


ODFH 


;NSNR.7 - 


SEND SEQUENCE COUNTER-BIT 2 





80515/80535 



MXO 


BIT 


0D8H 


;ADCON.O 


- ANALOG INPUT CH SELECT 


BIT 





MX1 


BIT 


0D9H 


;ADC0N.1 


- ANALOG INPUT CH SELECT 


BIT 


1 


MX2 


BIT 


ODAH 


;ADC0N.2 


- ANALOG INPUT CH SELECT 


BIT 


2 


ADM 


BIT 


00 BH 


;ADC0N.3 


- A/D CONVERSION MOOE 






BSY 


BIT 


ODCH 


;ADC0N.4 


- BUSY FLAG 






CLK 


BIT 


ODEH 


;ADC0N.5 


- SYSTEM CLOCK ENABLE 






BD 


BIT 


ODFH 


;ADC0N.7 


- BAUD RATE ENABLE 







80C652/83C652 



CRO 


BIT 


0D8H 


;S1CON.O 


- CLOCK RATE 


CR1 


BIT 


0D9H 


;S1C0N.1 


- CLOCK RATE 1 


AA 


BIT 


OOAH 


;S1C0N.2 


- ASSERT ACKNOWLEDGE 


SI 


BIT 


OOBH 


;S1C0N.3 


- SI01 INTERRUPT BIT 


STO 


BIT 


ODCH 


;S1C0N.4 
;S1C0N.5 


- STOP FLAG 


STA 


BIT 


ODDH 


- START FLAG 


ENS1 


BIT 


ODEH 


;S1C0N.6 


- ENABLE SI01 



80C152/83C152 



DMA 


BIT 


0D8H 


;TSTAT.O 


- DMA SELECT 


TEN 


BIT 


0D9H 


;TSTAT.1 


- TRANSMIT ENABLE 


TFNF 
TDN 


BIT 


ODAH 


;TSTAT.2 


- TRANSMIT FIFO NOT FULL 


BIT 


ODBH 


;TSTAT.3 


- TRANSMIT DONE 


TCDT 


BIT 


ODCH 


;TSTAT.4 


- TRANSMIT COLLISION DETECT 


UR 


BIT 




;TSTAT.5 


- UNDERRUN 


LNI C 


BIT 




;TSTAT.6 


- NO ACKNOWLEDGE 




BIT 


ODFH 


;TSTAT.7 


- LINE IDLE 


HBAEN 


BIT 


0E8H 


;RSTAT.O 


- HARDWARE BASED ACKNOWLEDGE EN 


GREN 


BIT 


0E9H 


;RSTAT.1 


- RECEIVER ENABLE 


RFNE 


BIT 


OEAH 


;RSTAT.2 


- RECEIVER FIFO NOT EMPTY 


RDN 


BIT 


OEBH 


;RSTAT.3 


- RECEIVER DONE 


CRCE 


BIT 


OECH 


;RSTAT.4 


- CRC ERROR 


AE 


BIT 


OEDH 


;RSTAT.5 


- ALIGNMENT ERROR 


RCABT 


BIT 


OEEH 


;RSTAT.6 


- RCVR COLLISION/ABORT DETECT 


OR 


BIT 


OEFH 


;RSTAT.7 


- OVERRUN 


PGSRV 


BIT 


0F8H 


;IPN1.0 - 


GSC RECEIVE VALID 


PGSRE 


BIT 


0F9H 


;IPN1.1 - 


GSC RECEIVE ERROR 


PDMAO 


BIT 


OFAH 


;IPN1.2 - 


DMA CHANNEL REQUEST 


PGSTV 


BIT 


OFBH 


;IPN1.3 - 


GSC TRANSMIT VALID 


PDMA1 


BIT 


OFCH 


; IPM1 .4 - 


DMA CHANNEL REQUEST 1 


PGSTE 


BIT 


OFDH 


;IPN1.5 - 


GSC TRANSMIT ERROR 



80C452/83C452 



OFRS 


BIT 


0E8H 


;SLCON 


.0 


- OUTPUT FIFO CH REQ SERVICE 


IFRS 


BIT 


0E9H 


;SLCON 


.1 


- INPUT FIFO CH REQ SERVICE 


FRZ 


BIT 


OEBH 


;SLCON 


.3 


- ENABLE FIFO DMA FREEZE MODE 


ICOI 


BIT 


OECH 


;SLCON 


.4 


- GEN INT WHEN IMMEDIATE COMMAND 
OUT REGISTER IS AVAILABLE 


ICII 


BIT 


OEDH 


;SLCON 


.5 


- GEN INT WHEN A COMMAND IS 
WRITTEN TO IMMEDIATE COMMAND I 


OF I 


BIT 


OEEH 


;SLCON 


.6 


- ENABLE OUTPUT FIFO INTERRUPT 


IFI 


BIT 


OEFH 


;SLCON 


.7 


- ENABLE INPUT FIFO INTERRUPT 


EFIFO 


BIT 


0F8H 


;IEP.O 




FIFO SLAVE BUS I/F INT EN 


PDMA1 


BIT 


0F9H 


; IEP.1 




DMA CHANNEL REQUEST 1 


PDMAO 


BIT 


OFAH 


;IEP.2 




DMA CHANNEL REQUEST 


EDMA1 


BIT 


OFBH 


;IEP.3 




DMA CHANNEL 1 INTERRUPT ENABLE 


EDMAO 


BIT 


OFCH 


;IEP.4 




DMA CHANNEL INTERRUPT ENABLE 


PFIFO 


BIT 


OFDH 


;IEP.5 




FIFO SLAVE BUS I/F INT PRIORITY 



N REG 



80C451/83C451 



IBF 


BIT 


0E8H 


;CSR 


- 


INPUT BUFFER FULL 


OBF 


BIT 


0E9H 


;CSR 


1 - 


OUTPUT BUFFER FULL 


IDSM 


BIT 


OEAH 


;CSR 


2 - 


INPUT DATA STROBE 


OBFC 


BIT 


OEBH 


;CSR 


3 - 


OUTPUT BUFFER FLAG CLEAR 


MAO 


BIT 


OECH 


;CSR 


4 - 


AFLAG MOOE SELECT 


MA1 


BIT 


OEDH 


;CSR 


5 - 


AFLAG MOOE SELECT 


s 


BIT 


OEEH 


;CSR 


6 - 


BFLAG MODE SELECT 




BIT 


OEFH 


;CSR 


7 - 


BFLAG MOOE SELECT 



83C751/83C752 



ptci 


RTT/DFA.n\ nn O u 


iPPFr n 




CLOCK TIMING u 


PT1 

u i i 


RTTfPFAn^ finou 
diivkcmu; UUyn 


1 c\~ r ij , | 




CLOCK TIMING 1 


1 1 RUN 


D 1 l ^KLHU ; UDCH 






START/STOP TIMER 1 


HMO 1 KU 


RTTfPFAn^ nnnu 






MASTER ldC 


SLAVEN 


R T T ( PFfin ^ nn cu 
oi i vkchuj uurn 






SLAVE l£L 




R 1 t f up iTP\finnu 

D 1 1 WK 1 1 t JUUoH 


iPPFr n 




CLOCK TIMING U 


PT1 

U 1 1 


R I Tf UP I TP \DnOU 






CLOCK TIMING 1 


T I RUN 


R T T f UP T TF ^ fin ru 


I2CFG 4 




STAKT/STUr IIMtK I 


PI PT I 
ULrt 1 1 


R I Tf up t tf Minnu 


1 LLru . j 




ri cad T T ucd 1 IkJTFDPIIPT Fl AP, 
CLfcAK I IMbK I IN I LKKUr I rLrtu 


MHO 1 RU 


R I t /up t tf >nncu 


T?PFr A 




MASTER 


oLMVCn 


HIT f\JD itc\ nn c u 
d l l ^ WK 1 1 1 JUUr H 






SLAVE I^C 


RSTP 


BITfRFAn> ("IFflH 


I 2STA. 




vuiT cthd rnun tti nu 

AMI 1 5 1 Ur LUNU1I1UN 


RSTR 


BIT(READ) 0F9H 


I2STA.1 




XMIT REPEAT STOP COND. 


MAKSTP 


BIT(READ) OFAH 


I2STA.2 




STOP CONDITION 


MAKSTR 


BIT(READ) OFBH 


I2STA.3 




START CONDITION 


XACTV 


BIT(READ) OFCH 


I2STA.4 




XMIT ACTIVE 


XDATA 


BIT (READ) OFDH 


I2STA.5 




CONTENT OF XMIT BUFFER 


RIDLE 


BIT(READ) OFEH 


I2STA.6 




SLAVE IDLE FLAG 



80C552/83C552 



CRO 


BIT 


0D8H 


S1CON.0 


- CLOCK RATE 




CR1 


BIT 


0D9H 


S1C0N.1 


- CLOCK RATE 1 




AA 


BIT 


ODAH 


S1C0N.2 


- ASSERT ACKNOWLEDGE 




SI 


BIT 


ODBH 


S1C0N.3 


- SERIAL I/O INTERRUPT 


STO 


BIT 


ODCH 


S1C0N.4 


- STOP FLAG 




STA 


BIT 


ODDH 


S1C0N.5 


- START FLAG 




ENS1 


BIT 


ODEH 


S1C0N.6 


- ENABLE SERIAL I/O 




ECTO 


BIT 


0E8H 


IEN1.0 - 


ENABLE T2 CAPTURE 




ECT1 


BIT 


0E9H 


IEN1.1 - 


ENABLE T2 CAPTURE 1 




ECT2 


BIT 


OEAH 


IEN1.2 - 


ENABLE T2 CAPTURE 2 




ECT3 


BIT 


OEBH 


IEN1.3 - 


ENABLE T2 CAPTURE 3 




ECMO 


BIT 


OECH 


IEN1.4 - 


ENABLE T2 COMPARATOR 





ECM1 


BIT 


OEDH 


IEN1.5 ■ 


ENABLE T2 COMPARATOR 


1 


ECM2 


BIT 


OEEH 


IEN1.6 • 


ENABLE T2 COMPARATOR 


2 


ET2 


BIT 


OEFH 


IEN1.7 - 


ENABLE T2 OVERFLOW 




PCTO 


BIT 


0F8H 


IP1.0 - 


T2 CAPTURE REGISTER 




PCT1 


BIT 


0F9H 


IP1.1 - 


T2 CAPTURE REGISTER 1 




PCT2 


BIT 


OFAH 


IP1.2 - 


T2 CAPTURE REGISTER 2 




PCT3 


BIT 


OFBH 


IP1.3 - 


T2 CAPTURE REGISTER 3 




PCMO 


BIT 


OFCH 


IP1.4 - 


T2 COMPARATOR 




PCM1 


BIT 


OFDH 


IP1.5 - 


T2 COMPARATOR 1 




PCM2 


BIT 


OFEH 


IP1.6 - 


T2 COMPARATOR 2 




PT2 


BIT 


OFFH 


IP1.7 - 


T2 OVERFLOW 





80C517/80C537 



F1 


BIT 


0D1H 


;PSW.1 - FLAG 1 






MXO 


BIT 


0D8H 


;ADCON0.0 


- ANALOG INPUT CH SELECT 


BIT 





MX1 


BIT 


0D9H 


;ADCON0.1 


- ANALOG INPUT CH SELECT 


BIT 


1 


MX2 


BIT 


OOAH 


;ADC0N0.2 


- ANALOG INPUT CH SELECT 


BIT 


2 


ADM 


BIT 


0D8H 


;ADCON0.3 


- A/D CONVERSION MODE 






BSY 


BIT 


ODCH 


;ADCON0.4 


- BUSY FLAG 






CLK 


BIT 


ODEH 


;ADCON0.5 


- SYSTEM CLOCK ENABLE 






BO 


BIT 


ODFH 


;ADCON0.7 


- BAUD RATE ENABLE 







80C154/83C154 



ALF 


BIT 


0F8H 


IOCON.O - 


CPU POWER DOWN MODE CONTROL 


P1F 


BIT 


0F9H 


I0C0N.1 - 


PORT 1 HIGH IMPEDANCE 


P2F 


BIT 


OFAH 


I0C0N.2 - 


PORT 2 HIGH IMPEDANCE 


P3F 


BIT 


OFBH 


I0C0N.3 - 


PORT 3 HIGH IMPEDANCE 


IZC 


BIT 


OFCH 


I0C0N.4 - 


10K TO 100 K OHM SWITCH (PI 


SERR 


BIT 


OFDH 


I0C0N.5 - 


SERIAL PORT RCV ERROR FLAG 


T32 


BIT 


OFEH 


I0C0N.6 - 


32 BIT TIMER SWITCH 


WOT 


BIT 


OFFH 


I0C0N.7 - 


WATCHDOG TIMER CONTROL 



Appendix C: Supported Parts And Emulation 

Probe Card Support Guide 



Applications may be developed for a microcontroller other than the specific controller supported by your 
probe card. For example, an 8052 probe card can be used to develop 8031 applications as long as you do 
not attempt to use Port or Port 2 (the address/data bus for the 8031) for I/O. An 8032 probe card can be 
used to develop 8031 applications as long as the program does not make use of Timer 2 or the additional 
128 bytes of internal data RAM. 

The SFR's, the key to emulation compatibility, were originally defined in the 8051. In later proliferation 
psrts, bytes that were unused in the 8051 were defined to support and control new features or functions 
such as new ports and analog to digital converters. The original SFR addresses are rarely redefined. 

The following list shows which microcontrollers are supported by each of the available probe cards: 

8052 Probe Card 

8031 8032 
80C31 80C32 



80C51FA Probe Card 

8031 80C31 
80C154 Probe Card 
8031 80C31 
80C521 Probe Card 

8031 8051 
80C31 80C51 



80C321 Probe Card 

8031 80C31 
8031 Probe Card 

8031 80C31 

8032 Probe Card 
8031 8032 
8344 Probe Card 
8344 

83C751 Probe Card 

83C751 87C751 
83C752 Probe Card 
83C752 87C752 
80C535 Probe Card 

80535 80C535 



8051 8052 8053 80C154 80C32T2 

80C51 80C52 8753 83C154 80C52T2 

8751 8752 85C154 

87C51 87C52 

8032 80C32 80C51FA 80C32T2 

8032 80C32 80C154 80C32T2 

8053 80C321 80C541 80C32T2 

8753 80C521 87C541 
8751 87C521 
87C51 

80C321 80C32T2 



80C31 80C32 80C32T2 
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87C451 



80532 Probe Card 

80532 

80C537 Probe Card 

80C537 

80C451 Probe Card 

80C451 

83C4S1 Probe Card 

80C451 83C451 
80C552 Probe Card 

80C552 

83CS52 Probe Card 

80C552 83C552 87C552 
80C652 Probe Card 
8031 80C31 
83C152 Probe Card 
80C152JA/JC 
80C152JB/JD (limited) 
80C851 Probe Card 
8031 80C31 
83C053 Probe Card 
83C053 83C054 
80CL410 Probe Card 
80CL410 

80515 Probe Card 

80515 80C515 



80C517 Probe Card 



80C517 
83C550 Probe Card 
80C550 83C550 
83C652 Probe Card 
80C652 83C652 
83C654 Probe Card 
80C652 83C654 



80C32T2 80C652 
83C152JA/JC 

80C851 
87C054 



80535 



80C535 



87C550 
87C652 
87C654 
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Appendix D: Character Sets 



Single Line Assembler Character Set 



The legal character set for the Single Line Assembler (pisplaylAlter\AsmlDasm {Assemble, page 7-37) is 
made up of the following characters (listed in ascending ASCII order): 

#$'()*+,-./ 01-9:? @A-Z_a-z 



Fill Search Pattern Character Set 



The legal character set for the fill pattern specification (Display/Alter \ Code \ Fill, Display/Alter | Idata | Fill 
and Display <, /Alter \Xdata\ Fill, (page 7-38) is made up of the following characters (listed in ascending 
ASCII order): 

'0-9 7A-Z a-z 
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Appendix E: Using Symbols 



Symbolic Debug Support Features 



The emulator host software includes specific support for programs written in high level languages (e.g., 
Intel PL/M-51, Archimedes C, Franklin C, etc.). Features include: 

• Multi-Module Support 

- Handling of local symbols 

• Source Line Numbers 

- Source line number included in disassembly (Code Disassembly and Main Source Window) 

- Simple Breakpoints by source line number (single line number or a range of line numbers) 

- Single-Step by source line number (within a module or across entire program) 

- Single-Step by procedure/function entry points 

- Go (resume execution) at a particular source line number 

• Ranges in Simple Breakpoints (" < from_addr > - < to_addr > ") 

Note that when debugging C code, several compilers (such as Archimedes C) are stack oriented in that 
local automatic variables are referenced using the stack and cannot be referenced symbolically. If you 
need to reference this type of variable symbolically during debugging, they should be declared as 'static'. 

Syntax For Symbolic Input 

Symbols (Code Labels And Variable Names) 



In all cases where you may specify a name (code label or variable name) from the keyboard, the following 
syntactic forms are recognized/required. Each form is followed by a description of what the host software 
does to locate the appropriate definition of the symbol: 

< name > 

First search for < name > in local symbols of the current module; If not found, then search for < name > 
in the program's global symbols. 

USAGE: to designate a global symbol or a local symbol defined immediately within the current module. 

< ModuleName > : < name > 

Search for < name > in local symbols of module < Module Name > . 

USAGE: to designate a local symbol defined immediately within the module < Module Name > . 

< ModuleName > : < ProcedureName > : < name > 

Search for <name> in the local symbols of procedure/function < Procedure_Name > in module 

< ModuleName > . 
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USAGE: to designate a local symbol defined immediately within the procedure/function <Proce- 
dureName > which is located in module < Module_Name > . 

Note that this form may be shortened to < ProcedureName > : < name > if the < Procedure Name > , 
even though it may be a local symbol within the module, is not repeated (duplicated) in another module. 
For example, if we want to reference the local variable J defined in procedure PROCX which is 
contained in module MODM, we could specify MOD_M:PROC_X:J. If PROC X is not defined as a 
module name or as a local procedure/function in any other module in the program, we could shorten the 
specification to PROC_XJ. Furthermore, if it happens that this local symbol J is not defined in any other 
procedure or module of the program, then we could simply specify J. 

Line Numbers 



At any place where a code address or label can be specified, a line number can also be specified (e.g., 
art address, simple breakpoint, etc.). Line numbers are specified as follows: 



#<n> 

designates source line number < n > in the current module. 
< ModuleName > :# < n > 

designates source line number < n> in module < Module Name > . 

Examples Of Absolute And Symbolic Input 



0A7h 
132 



START 



MODA:RESTART 
#45 

MODA:#14 
MODA:PROC:ARG 

MODA:PROC:FUNC:I 



absolute address (hexadecimal) 
absolute address (decimal) 

label or variable START defined as a global (public) symbol 
or a local symbol in the current module 

label or variable RESTART which is defined as a local 
symbol in module MODA 

source line number 45 in the current module. 

source line number 14 in module MODA 

label or variable ARG which is defined as a local symbol 
within the procedure/function PROC which is contained 
within the module MODA 

denotes the local variable I defined within function FUNC 
which is contained within procedure PROC which is 
contained within module MODA (applies only to PL/M-51 
as the C language does not allow nested function definitions) 
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Appendix F: File Formats 



The emulator Host software supports three basic object file formats; the Intel Hex format, the Motorola 
S-Record format and the Intel Absolute Object Module format (commonly called AOMF). You do not 
need to distinguish between them when loading a program. Each is described below: 

Intel Hex / Motorola S-Record Object File (PROMable) 



This is an ASCII file format which is normally used as input to PROM programming utilities. In its "pure 
form", a Hex file contains no symbolic debug information. 

However, extensions to this file format are supported by various third parties (e.g., Microtec Research) 
in which a limited amount of symbolic information is present. The general format of a Hex or S-Record 
file is as follows: 



Symbolic Information Format (optional, at head of file) (Microtec. BSO) ) 

NOTE: This format does not conform specifically/exactly to anyone's 
(e.g., Microtec 's, BSO's, etc.) current format for symbolic 
information. The specification given here (which is what the 
Host Software actually supports during program loading) is a 
♦superset* of all those variations. 

<ws*x$_or_$$><ws*><mod_name_optxws*xnewline> {1st optional} 
<ws * xnum_optxws *><memsp_optxws * x symbolxws+xaddr> 

1| I I 

| 2 | |_ Sequence may repeat any number of times within a single re- 

cord. 

I I 

<ws*xnum_optxws*xmemsp_optxws*xsymbolxws+xaddr> 

I | 

<ws*><num optxws*xmemsp optxws*xsymbolxws+xaddr> 

I 



<ws*x$_or_$$xws*xnewline> (symbolic info terminator) 

where <ws*> == Zero or more whitespace 

(blank or horizontal tab) characters. 
<ws+> == One or more whitespace 

(blank or horizontal tab) characters. 
<$_or_$$> == A single dollar sign character ('$') 

or two dollar sign characters ('$$'). 
<num_opt> == A single zero character ('0'), 

or a decimal/octal number, 

or nothing. (ignored) 
<memsp_opt>== Optional memory space designator number : 

Code ROM/PROM (simple label, proc/func name) 
{applicable to MCS-51,68HCll,COP8} 

1 External data RAM 
{applicable to MCS-51} 
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2 Direct (internal directly-addressable RAM) 
{applicable to MCS-51,COP8} 

3 Indirect (internal indirectly-addressable RAM) 
{applicable to MCS-51} 

4 Bit (internal bit-addressable RAM) 
{applicable to MCS-51} 

5 Number (e.g., assembly language EQU) 
{applicable to MCS-51, 6 8HCll,COP8} 

If this designator is present, <num_opt> must 
also be supplied (and the <ws*> between <num_opt> 
and <memsp_opt> is actually <ws+>) . 
68HC11 NOTE: If <memsp_opt> is 2 (internal 
directly-addressable RAM) , it will be changed to 
(code memory) before insertion into the internal 
Symbol Table. This is done because the 6 8HC11 has 
a single, uniformly-addressable 64K memory space 
for both code and data. 
== symbol's address /value : Zero to 5 characters from 
the sets '0'-'9', 'A'-'F', 'a'-'f. The symbol's 
address /value will be treated as a hexadecimal 
number. The <addr> may be terminated by an 
optional radix character, 'H' or 'h'. 
End-of -record . 

1. If a module name is supplied, subsequent symbol definitions will be 
treated as local symbols within that module. Otherwise, subsequent sym- 
bol definitions will be treated as global (public) symbol definitions. 

2. One or more symbol records (each containing one or more symbol 
definitions) per module. 



<addr> 



<newline> 



The '$' or '$$' record separating the symbol records from the code re- 
cords is optional for Intel Hex files (':'), but required for Motorola 
S-Record files. 



?X Format 



| | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | | xx | xx | 



: | bytes : address | type | datal | data2 \ | cksum 



NOTE: No whitespace is allowed preceding the ':' at the beginning of 
each text record. 

1. 'cksum' does not including the leading ':' character. All remaining 
bytes, including the checksum byte, are added; the result must be zero. 

2. 'bytes' field is a count of the 'datan' pairs only. 

code Format; Motorola S-Record Format 1 



01 23 4567 xx xx 



Type | Record Length 


Address 


Code /Data 


Checksum 




( aaaa) 






(Sn) (11) 
1 


(aaaaaa) 






(aaaaaaaa) 


(dd. . .dd) 


(kk) 
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11 == length field (OO-FF) and is a count of character pairs 
which follow in this S-Record (including the checksum) . 

kk == checksum (least significant byte of the one's complement of 
the sum of the values represented by the pairs of characters 
making up the record length, address and code/data fields). 



2- byte load address. 

3 - byte load address. 

4- byte load address. 



50 11 aaaa <opt> kk 

Header record for a block of S-Records . 
aaaa (address field) is normally zeroes. 

51 11 aaaa dd...dd kk 

Text (Code /Data Init) , 

52 11 aaaaaa dd. . .dd kk 

Text (Code/Data Init), 

53 11 aaaaaaaa dd. . .dd kk 

Text (Code /Data Init), 

54 11 ??? kk 

? 

55 11 nnnn kk 

Count of S1,S2 and S3 records (transmitted) 
in a particular block. 

'nnnn' == count (appears in address field) 

56 11 ??? kk 

j 

57 11 aaaaaaaa kk 

Termination Record for a block of S3 records, 
aaaaaaaa == optional 4-byte entry address 

58 11 aaaaaa kk 

Termination Record for a block of S2 records . 
aaaaaa == optional 3-byte entry address 

59 11 aaaa kk 

Termination Record for a block of Si records, 
aaaa == optional 2-byte entry address 



NOTE: No whitespace is allowed 
each text record. 



preceding the"Sn" at the beginning of 



These record types are not 



during loading. 



GENERAL NOTE: We also allow intermixing of Intel Hex Format records and 
Motorola S-Record Format Records. 



Intel Absolute Object Module Format (AOMF) File 



This is a binary file format which is composed of, at a minimum, object records containing code to be 
loaded. Depending on which compilation and link options are used (see Appendix H, Recommended 
Compilation Options), there may also be object records containing symbolic information such as labels, 
variable names, module scope definitions, line numbers and variable type information. 
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Appendix G: HLL Support Of Third Party Software 

Source Level Debug Support 



The Host Software includes support for debugging HLL (High-Level Language) programs (e.g., C and 
PL/M-51) at the source level. If the program loaded into code memory contains the appropriate debug 
records (see Appendix H, Recommended Compilation Options), the Host Software is able to display 
HLL source in traces, disassemblies and other contexts. 

Any time a program is loaded using the File \Load command (page 7-27) or File {Restore command (page 
7-28), the Host Software attempts to locate the source file corresponding to each module in that program 
in the directory specified by the HLL search path. The path can be set in one of three ways: 

1) (statically) on command line invocation of software via the '-s < source_path > ' option (see 
Appendix J) 

2) (dynamically) using the Source/Symbols {Source Path command (page 7-52) 

3) (automatically) if the path has not been set via the command line option, the path is set to the current 
directory at initialization 

Once the path is set it will not change unless changed dynamically using the Source/Symbols { Source Path 
command. In fact, changing the current working directory during an escape to DOS (File { OS-Escape) has 
no effect on the path. 

If the program contains source line number debug records (see Recommended Compilation Options), 
the Host Software will "remember" the position of each source image for which there is a line number 
debug record entry. This is done so that HLL displays can be generated quickly. 

During the search for source files, messages are displayed on the Quick Help Line to inform the user of 
the Host Software's progress. The length of time these messages are displayed (from zero to thirty 
seconds) is controlled by model file directive A36 (Appendix M). 

For each module containing line number debug records for which the corresponding source file is found, 
the following message is displayed: 

Source Found Fon < modulename > 

If the source file was found in the current directory, as opposed to being found in the directory specified 
in the HLL search path, the < module name > in the above message will be preceded by an asterisk. 

If the program contains module and line number debug records, but the Host Software is unable to locate 
any source file (for at least one module in the program), the following message is displayed: 

Source Line Numbers Present, but No Source Files Found 

If this message appears when source files are available (and source-level debug is desired), make sure that 
the HLL search path is set correctly. 

If the program contains no module or line number debug records, the following message is displayed: 

No Source Line Numbers Present 
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If this message appears when source files are available (and source-level debug is desired), make sure that 
the modules in the program were compiled with the appropriate debug options, and that the program was 
linked with the appropriate debug options. 

Note that this message always will appear, if enabled, for programs composed only of assembly language 
modules. 



Locating Source Files 



The Host Software must be able to locate the source file(s) for the module(s) in a program given only the 
module name(s). The module names are all that is provided in the debug records in the absolute object 
module format file. Given a module name, < module name > , the Host Software will search (through the 
directories/paths described above), for the first fde named: 

< module name>.C 



If such a fde is found, that fde is assumed to contain "raw" C source code. C compilers normally supply a 
module name in the object module's debug records which is the same as the source file name without the 
\C* suffix It is from this '.C fde that Host Software obtains the source images displayed in < 
and traces. 



< module_name > .LST 



If such a file is found, that file is assumed to contain the source listing generated by the PL/M-51 compder. 
The emulator Host Software must read this fde, rather than the original PL/M-51 source file, because the 
"line numbers" provided by the PL/M-51 compder in the object module's debug records are not really line 
numbers at all, but rather statement numbers, as determined by the PL/M-51 compder. These statement 
numbers are also present in the '.LST' file generated by the PL/M-51 compder. It is from this '.LST' file 
that the Host Software obtains the source images displayed in disassemblies and traces. 

Note that the debug records in an absolute object module format fde give no explicit indication of a 
module's original source language, nor do they specify the program (assembler or compiler) which 
created the relocatable object module corresponding to a module in the linked program. 

Di splay Formatting Of Source Images 

The user has control over the following aspects of the display format of HLL source images in ad menus: 

1) Whether or not to skip (ignore) leading blanks in each source image. The default action is not to 
skip leading blanks. 

2) The tab stop settings (column width) to be used for the ASCII horizontal tab character (09 hex). 
The default tab stop setting is 4 (i.e., a 4-character column width between tab stops). 

For more detads see directive A41 in Appendix M, Model File Configuration. 
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Characteristics Of Third-Party Multi-Module Debug Support 



These characteristics are determined by the particular language processor and its implementation. They 
affect the Host Software's capabilities, but are beyond the Host Software's control. 

Archimedes C-51 Release V.2.01 



1) Line numbers correspond to source file line numbers (relative source record numbers). 

2) The run-time library contains debug symbol tables for each entry point for each module in the 
library. Thus, in single-stepping by procedure/function entry points, the run-time library routines 
are not transparent; a break will occur on entry to each run-time library routine. 

3) The run-time library does not contain debug line number tables for the modules in the library. Thus, 
in single-stepping by line number across all modules in the program, the run-time library routines 
are transparent; no breaks will occur in run-time library routines. 

Franklin C51 (V2.12) With L51 (V2.4) 



1) Line numbers correspond to source file line numbers (relative source record numbers). 

2) The run-time library contains debug symbol tables for each entry point for each module in the 
library. Thus, in single-stepping by procedure/function entry points, the run-time library routines 
are not transparent; a break will occur on entry to each run-time library routine. 

3) The run-time library does not contain debug line number tables for the modules in the library. Thus, 
in single-stepping by line number across all modules in the program, the run-time library routines 
are transparent; no breaks will occur in run-time library routines. 

4) There is a local code label (_ICE5100_BUG_) generated by the compiler for each module created 
by the user. This symbol will cause no problems. 

5) Line numbers corresponding to the end of a FOR loop are not as one would expect. It seems that 
the line number of the FOR statement itself is also used for the last line of the FOR loop. This is 
due to the nature of the line number tables generated by the C51 compiler and cannot be remedied 
by the Host Software. 

The code in Figure 1 shows a line number table created with this quirk. 
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17 


1 


for (i =0; i < repeat; { 


18 


2 


wastetime O; 




19 


2 


if (P1 0) 




20 


2 




P1 = 0; 


> 


21 


2 


else 




22 


2 




P1 = 1; 




23 


2 


state = 0; 




24 


2 


if 


<P1 0) 




25 


2 




state = (state) 7 0:1; 


26 


2 


> 


/* end of: for 


;i */ 


27 


1 


> /* 


end of function 


*/ 










SOURCE LINE # 17 


0000 


E4 


CLR 


A 




0001 


F500 


R MOV 


i.A 




0003 




7C0001 : 






UUUJ 




CLR 


C 




0004 


E500 


R MOV 


A,i 




0006 


9500 


R SUBB 


A, repeat cnt 




0008 


A2E7 


MOV 


C.ACC.7 




000A 


30D201 


JNB 


OV,?C0009 




000D 


B3 


CPL 


C 




000E 




7C0009: 






000E 


5022 


JNC 


?C0002 


SOURCE LINE # 18 


0010 


120000 


E LCALL 


wastetime 




0013 


309704 






SOURCE LINE # 19 
SOURCE LINE # 20 


JNB 


P1_0,?C0004' 

■ 


0016 


C297 


CLR 


P1 




0018 


8002 


SJMP 


7C0005 




001A 




7C0004: 




SOURCE LINE # 22 


001A 


D297 


SETB 


P1_0 




001C 




7C0005: 


; 


SOURCE LINE # 23 


001C 


E4 


CLR 


A 


SOURCE LINE # 24 


001D 


F500 


E MOV 


state, A 


001 F 


30970C 


JNB 


P1_0,?C0003' 


SOURCE LINE # 25 


0022 


E500 


E MOV 


A, state 




0024 


6004 


JZ 


7C0007 




VUC.O 


7pnn 
i ruu 


MOV 


R7,#00H 
7C0008 




0028 


8002 


SJMP 




002A 




7C0007: 






002A 


7F01 


MOV 


R7,#01H 




002C 




7C0008: 




002C 


8F00 


E MOV 


state, R7 




002E 




7C0003: 


SOURCE LINE # 17 


002E 


0500 


R INC 


i 




0030 


80D1 


SJMP 


7C0001 




0032 




7C0002: 






0032 


22 


RET 







Figure G-l. Franklin C51 - FOR Loop 
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Intel PL/M-51 (V1.2) With RL51 (V3.0) 



1) Line numbers are actually statement numbers, as determined by the compiler. These statement 
numbers appear as the first column of numbers in the source listing generated by the compiler (LIST 
option). The statement numbers also appear as comments in the generated object code listing 
(CODE option). 

2) The run-time library (PLM51.LIB) contains neither debug symbol tables nor debug line number 
tables for the modules in the library. Thus, in single-stepping by line number across all modules in 
the program or in single-stepping by procedure/function entry points, the run-time library routines 
are transparent; no breaks will occur in run-time library routines. 

3) The apparent behavior of single-stepping by line number across an IF-THEN-ELSE statement is 
not exactly what one would expect. If the ELSE branch of an IF-THEN-ELSE statement is taken, 
control will appear to transfer from evaluation of the IF condition to the statement following the 
ELSE statement. 

If the ELSE statement is a compound statement (simple DO block), control will appear to transfer 
("correctly") from evaluation of the IF condition to the first statement in the ELSE block. 

This is due to the nature of the line number tables generated by the PL/M-51 compiler and cannot 
be remedied by the Host Software. 

Examine the code in Figure 2 generated for a simple IF-THEN-ELSE statement and in Figure 3 
generated for a compound IF-THEN-ELSE statement and the location of the line number 
comments; these comments accurately reflect the actual content of the line number table generated 
by the compiler for the module: 



28 


2 




IF sw$b THEN 


29 


2 




CALL proc b1; 


30 


2 




ELSE 

CALL proc b2; 


31 


2 




RETURN arg; 








; STATEMENT # 28 
JNB SUB,THEN?5 

; STATEMENT # 29 


002B 


300005 


F 


002E 


120000 


F 


LCALL PROC B1 

; STATEMENT # 30 


0031 


8003 




SJMP ELSE76 


0033 




THEN75: 




0033 


120000 


F 


LCALL PROC B2 

; STATEMENT # 31 


0036 




ELSE76: 




0036 


E500 


F 


MOV A,ARG+0001H 


0038 


22 




RET 



Figure G-2. Intel PL/M-51 - Simple IF-THEN-ELSE 
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28 


2 




IF su$b THEN 


29 


2 




CALL proc b1; 


30 


2 




ELSE 

DO; 


31 


3 




CALL proc_b2; 


32 


3 




CALL proc b2; 


33 


3 




CALL proc b2; 


34 


3 




END; 


35 


2 




RETURN arg; 








; STATEMENT # 28 
JNB SW8,THEN?5 

; STATEMENT # 29 


002B 


300005 


F 


002E 


120000 


F 


LCALL PROC B1 

; STATEMENT # 30 


0031 
0033 


8009 


THEN75: 


SJMP ELSE76 

; STATEMENT # 31 


0033 


120000 


F 


LCALL PROC B2 

; STATEMENT # 32 


0036 


120000 


F 


LCALL PROC B2 








; STATEMENT # 33 


0039 


120000 


F 


LCALL PROC B2 

; STATEMENT # 35 


003C 
003C 


E500 


ELSE76: 

F 


MOV A.ARG+0001H 


003E 


22 




RET 



Figure G-3. Intel PL/M-51 - Compound IF-THEN-ELSE 



Micro Computer Control Corporation (MCC) MICRO/C-51 Release V1.3A 



1) The run-time library contains neither debug symbol tables nor debug line number tables for the 
modules in the library. Thus, in single-stepping by line number across all modules in the program or 
in single-stepping by procedure/function entry points, the run-time library routines are transparent; 
no breaks will occur in run-time library routines. 



Tasking PLMTI51 (V2.0b) with ASM51 (1.1a) and LINK51 (1.1a) 



1) Line numbers are actually statement numbers, as determined by the compiler. These statement 
numbers appear as the first column of numbers in the source listing generated by the compiler ('-p' 
option). The statement numbers also appear as comments in the generated assembly source code 
file. 

2) The run-time library contains debug symbol tables for each entry point for each module in the 
library. Thus, in single-stepping by procedure/function entry points, the run-time library routines 
are not transparent; a break will occur on entry to each library routine. 

3) The run-time library does not contain debug line number tables for the modules in the library. Thus, 
in single-stepping by line number across all modules in the program, the run-time library routines 
are transparent; no breaks will occur in run-time library routines. 

4) If a PL/M-51 source statement is spread over more than one line a line number table entry is output 
for only the last line of the range. This is due to the nature of the line number tables generated by 
the PL/M-51 compiler and cannot be remedied by the Host Software. The code in Figure 4 shows 
an example of this behavior. 



17 2 sw$main = true; 

18 2 DO k = 9 TO 11 BY 1; 

19 3 j = (arg + k) 

20 3 * 

21 3 5; 

22 3 END; /* k */; 



DM_M0DA:#17: 
01B8 D201 
DH M00A:#18: 
01BA 752C09 
01BD E52C 
01BF D3 
01 CO 940B 
01C2 501F 
DM_M0DA:#21 
01 C4 7F05 
01C6 7E00 
01C8 AB2C 
01 CA 7A00 
01CC EB 
01 CD 2530 



swSmain = true; 

FUNC A: SETB SWHAIN 

DO k = 9 TP T1 BY 1; 

MOV 1,#09h 

3: MOV A, 1 

SETB C " 

SUBB A,#0Bh 

JNC _4 

5: MOV* R7,#05h 

MOV R6,#00h 

MOV R3, 1 

MOV R2,300h 

MOV A,R3 

ADD A,30h 



;DM_M0DA:#17 
;DM_MODA:#18 



;DM_M0DA:#21 



Figure G-4. Tasking PL/M-51 - Multiple Line Statement 
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Appendix H: Recommended Compilation Options 



Archimedes Products 



1) Archimedes 'a8051' (relocatable assembler for MCS-51): 

S Put all symbols (local and global) into object module 

2) Archimedes 'c-51' (C cross-compiler for MCS-51): 

-j Put static and local symbols into object debug tables for Release V2.01 

and earlier. 

or 

-rn Put static and local symbols into object debug tables for Release V3.00B 

and beyond. 

3) Archimedes 'xlink' (linker for MCS-51): 
-c8051 Define CPU as 8051 

-Faomf8051 Generate Intel Absolute Object Module (Load Module) Format 

-xsmi Generate cross-reference listing (optional) 

-z Disable overlay check (optional) 



Franklin Products 



1) Franklin 'a51' (relocatable assembler for MCS-51): 

$DEBUG Include debug information in object file 

2) Franklin 'c51' (C cross-compiler for MCS-51): 

CODE Append assembly language mnemonics list to \LST" file (optional) 

DEBUG Include debug (symbols 

INTVECTOR Put instruction at address to 'LJMP' past interrupt vectors 

OBJECTEXTEND Include variable data type definitions in object module 

3) Franklin '151' (linker for MCS-51): 

IXREF Generate cross reference report (optional) 

DEBUGLINES Include line number information in output file 

DEBUGPUBLICS Include public (global) symbol information in output file 

DEBUGSYMBOLS Include local symbol information in output file 
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Intel Products 








— 



1) Intel 'asm51' (relocatable assembler for MCS-51): 

Output relocatable object module to 'source_file_base_name.OBJ' 

Include debug symbol information in the object module 




2) Intel 'plm51' (PL/M-51 compiler for MCS-51): 

$DEBUG Generate debug records in the object module 

$LIST Allow listing of source lines 

SPRINT Output source listing to 'source file base name.LST' 

$CODE Append generated code listing to 'source_file_base_name.LST 

(optional) 



NOTE: All module names (in all source files) should be the same as the base name of the '.LST' 



dm_main:DO; /* beginning of main module (source file name:DM_MAIN.P51) */ 
END dmmain; 

dmmoda: DO; /* beginning of module A (source file name: DM MODA.P51) */ 
.... 

END dm moda; 
3) Intel 'xBl' (linker for MCS-51): 



DEBUGLINES 

DEBUGPUBLICS 

DEBUGSYMBOLS 

PRINT 

MAP 

SYMBOLS 
PUBLICS 
LINES 
IXREF 



Include line number information in output file 
Include public (global) symbols in output file 
Include local symbols in output file 
(optional) create link summary I 



(optional) output memory map to link summary 
(optional) output local symbols to link summary 
(optional) output public (global) symbols to link summary 
(optional) output line (statement) numbers to link summary 
(optional) output intermodule cross-reference to link summary 
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MetaLink Products 

l) MetaLink 'asm51' (absolute assembler for MCS-51): 

$DEBUG Generate Intel absolute object module format 

$OBJECT Generate Intel HEX format 



Micro Computer Control Corporation(MCC) Products 



1) MCC MICRO/C-51 'mcc51' (C cross-compiler for MCS-51): 

IX Generate source line number information 

/c Include C source as commentary in generated '.SRC (assembly 

language) source file (optional) 

2) If using Intel's assembler & linker to assemble generated '.SRC files and link the resultant 
relocatable object modules, see the recommended options for Intel Products in this appendix. 

3) Invoke MCC 'mcsu' (Statement Label Conversion Utility) with the linker-generated Absolute 
Object Module Format (AOMF) file as input. Note that you should be using MICRO/C- 51 V1.3 or 
later with the 'mcsu' conversion utility. 
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Tasking Products 



1) Tasking 'plmti51' (PL/M-51 compiler for MCS-51): 

The output from the compiler is assembly language source code that needs to be assembled by the 



-p Output source listing file to 'sourcefilebasename.LST' . This is the file 

that will be used by the host software for High Level Language 
debugging 

NOTE: All module names (in all source files) should be the same as the base name of the '.LST' 
listing file: 

dm_main:DO; /* beginning of main module (source file name:DM_MAIN.PLM) */ 
END dm main; 

dm_moda: DO; /* beginning of module A (source file name:DM_MODA.PLM) */ 

END dm moda; 

2) BSO/Tasking 'cc51' (C compiler for MCS-51): 

The output from the compiler is assembly language source code that needs to be assembled by the 
BSO/Tasking assembler. 

-gt generate the maximum amount of HLL symbolic debug information 

3) Tasking 'asm51' (relocatable assembler for MCS-51): 

PRINT(filename) Generate listing file. Be sure to use a filename extension other than 

'.LST' as the host software will use the '.LST' file generated by the 
compiler for High Level Language debugging 

DB Generate (enable) debug information 

DI(OBBh) Type of debug information generated (symbols and line numbers) 

4) Tasking 'link51' (linker for MCS-51): 

DL Include line number information in output file 

DP Include public symbol information in output file 

DS Include local symbol information in output file 

5) The output from the Tasking linker must be converted to the Intel Absolute Object Module Format 

; conversion utility 'oct_o51' in order to be loaded by the Host Software. 
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Appendix I: Using A Mouse 



While iceMASTER currently does not provide internal, direct support for a mouse, you can operate 
iceMASTER with a mouse by using the "mouse menu" utility normally supplied by each mouse manufac- 
turer. These mouse menu utilities allow you to define a mapping from mouse buttons/movements to 
keyboard keystrokes. 

Regardless of which mouse you are using, mouse movement should always be mapped as: 



Mouse Movement 


Kevstroke Mapping 


Left 


<*- 


Right 


-*■ 


Up 


t 


Down 


1 



You can control iceMASTER most effectively with a mouse if your mouse menu software allows you to 
define mouse buttons for at least the following keystrokes (2-button mouse): 



Mouse Button 


Kevstroke Mapping 


Left 


Enter 


Right 


Esc 


Left + Right 


Tab 



If you have a 3-button mouse, we recommend the following definitions: 



Mouse Button 


Kevstroke Mapping 


Left 


Enter 


Right 


Esc 


Middle 


Tab 


Left + Middle 


Home 


Left + Right 


Shift-Tab 


Left + Middle + Right 


Ctrl-E 



Specific details for setting up mouse menus are provided below for: 

Microsoft Mouse 
LOGITECH Mouse 
Mouse Systems White Mouse 

If your mouse is not listed above, refer to the mouse manufacturer's documentation. 

Additionally, if you decide to use a mouse in this manner, you will probably prefer to set the Configure \ Op- 
tions \Bad key/command toggle to OFF (page 7-21). 
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Microsoft Mouse Support 




The following paragraphs show how to set up a mouse menu for iceMASTER using a Microsoft Mouse 
(2-button). 

Assuming that the mouse driver files are located at C:\MSM, the following steps will create a mouse menu 
which can be loaded to control iceMASTER. The two files defining the mouse button/movement mapping 
will be created as C:\MSM\MENUS\ICE.DEF and C:\MSM\MENUS\ICE.MNU. To create 
ICE.MNU: 



MKDIR C:\MSM\MENUS 
CD C : \MSM\MENUS 
C:\* 



Edit 

Buttons : 

L(eft) 

R(ight) 

B(oth) 

Movement : 

L(eft) 
R(ight) 
U(p) <up> 
D ( own ) 

Save As 

C : \MSM\MENUS\ICE 
Make Menu 

ICE.MNU 



<Enter> 

<Esc> 

<Tab> 

<Left> 
<Right> 

<Down> 



The following is a fragment of an AUTOEXEC.BAT file which automatically loads the mouse driver and 
the iceMASTER mouse menu driver created above: 

REM AUTOEXEC.BAT Fragment for Microsoft Mouse: 
REM 

REM (Tested using Version 7.04 of the Microsoft Mouse Driver) 

REM (Microsoft Mouse software files at "C:\MSM\") 

REM 

REM 1. Load Mouse Driver: 

REM (COM2, Horizontal & Vertical Sensitivity of 10 

REM (range: 5-100, in increments of 5) ) 

C:\MSM\MOUSE /c2 /slO 
REM 

REM 2. Use "Unaccelerated" Mouse-Movement Profile: 

C:\MSM\SETSPEED /p4 / f C : \MSM\MOUSEPRO . FIL 

REM 



REM 3. Load "Control Panel" 

REM (invoke later with Ctrl-Alt-lef t_mouse_button) : 

REM C:\MSM\cpanel 

REM 

REM 4. Install iceMASTER Menu. 

REM iceMASTER menu files are C:\MSM\MENUS\ICE.DEF 

REM and C:\MSM\MENUS\ICE.MNU 

REM This menu defines the mouse buttons as follows: 

REM Buttons : Movement : 

REM Left = Enter L = Left 

REM Right = Esc r = Right 

REM Both = Tab u = Up 

REM d = Down 
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C:\MSM\MENU C:\MSM\MENUS\ICE 
REM 

REM Later, to dynamically remove one or more of the mouse utilities: 
REM cpanel OFF {remove Control Panel} 

REM MENU OFF {remove Mouse Menus } 

REM MOUSE OFF {remove Mouse Driver } 



LOGITECH Mouse Support 



The following paragraphs show how to set up a mouse menu for iceMASTER using a LOGITECH Mouse 
(3-button). 

Assuming that the mouse driver files are located at C:\LTM, the following steps will create a mouse menu 
which can be loaded to control iceMASTER. 

You first need to create a menu source file, ICE.DEF, containing the definitions mapping mouse 
movements/buttons to keyboard keystrokes. You can use any text editor or word processor to create a 
plain ("non-document") ASCII text file containing: 

; LOGIMENU File definition for iceMASTER 
; Horizontal Sensitivity: 150/200 
; Vertical Sensitivity: 140/200 

BEGIN leftb, midb, rightb, leftm, rightm, upm, downm, 150, 140 
CHORDS lmb, lrb, mrb, allb 



Mouse Buttons : 



leftb: TYPE ENTER ;Left Button 
midb: TYPE TAB ; Middle Button 
rightb: TYPE ESC ; Right Button 



Enter key 
Tab key 
Esc key 



Mouse Movement: 



leftm: 
rightm: 
upm: 
downm: 



TYPE 0,75 ;Left Movement 

TYPE 0,77 ; Right Movement 

type 0,72 ;up Movement 

TYPE 0,80 ;Down Movement 



Chords (multi-button press) 



lmb : TYPE 0,71 

mrb: TYPE 0,79 

lrb: TYPE 0,15 

allb: TYPE 5 



Left arrow key 
Right arrow key 
Up arrow key 
Down arrow key 



; Left + Middle 
• Middle + Right 

; Left + Right 

; Left + Middle + Right 



Home key 
End key 
Shift-Tab key combination 
key combination 



Then, compile this menu source file (CALTMATPF npci , 
(C:\LTM\ICE.MNU): \^ r M\ICE.DEF) to create the menu definition file 

CD C:\LTM 
NEWMENU ICE 
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The following is a fragment of an AUTOEXEC.BAT file which automatically loads the mouse driver and 
installs the iceMASTER mouse menu (C:\LTM\ICE.MNU) created above: 

REM AUTOEXEC.BAT Fragment for LOGITECH Mouse: 
REM 

REM (Tested using Version 3.42 of the LOGITECH Mouse Driver) 

REM (LOGITECH Mouse software files at "C:\LTM\" ) 

REM 

REM 1 . Load Mouse Driver : 

REM (use 'C:\LTM\MOUSE' if the mouse is on COMl) 

REM (use 'C:\LTM\MOUSE 2' if the mouse is on COM2) 
C:\LTM\MOUSE 2 
REM 

REM 2. install iceMASTER Menu. 

REM iceMASTER menu files are C:\LTM\ICE.DEF 

REM and C:\LTM\ICE.MNU 

REM This menu defines the mouse buttons as follows : 

REM Movement s 

REM Left = Left arrow key 

REM Right = Right arrow key 

REM Up = Up arrow key 

REM Down = Down arrow key 

REM Buttons : 

REM Left = Enter key 

REM Middle = Tab key 

REM Right = Esc key 

REM Left + Middle = Home 

REM Middle + Right = End 

REM Left + Right = Shift-Tab key combination 

REM Left + Middle + Right = Ctrl-E key combination 
REM 

REM C:\LTM\ICE.DEF is the raw source for the button/movement 

REM definitions. After creating C:\LTM\ICE.DEF, type 

REM CD C:\LTM 

REM NEWMENU ICE 

REM to create the C:\LTM\ICE.MNU menu definition file. 
REM 

C : \LTM\MENU C : \LTM\ ICE 
C : \LTM\CLICK 
REM 

REM Later, to dynamically remove one or more of the mouse utilities: 

REM CLICK OFF {remove Click } 

REM MENU OFF {remove Mouse Menus } 

REM MOUSE OFF {remove Mouse Driver} 
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Mouse Systems White Mouse Support 



The following paragraphs show how to set up a mouse menu for iceMASTER using a Mouse Systems 
White Mouse (3-button). 

Assuming that the mouse driver files are located at C:\MOUSE, the following steps will create a mouse 
menu which can be loaded to control iceMASTER. 

You first need to create a menu source file, M IM.MSC, containing the definitions mapping mouse 
movements/buttons to keyboard keystrokes. You can use any text editor or word processor to create a 
plain ("non-document") ASCII text file containing: 



; Mouse systems white Mouse Configuration for iceMASTER 
; 

; Cursor Definitions 

Cursdef : cursor 
( 

Left( [Left] ) 
Right ( [Right] ) 
Up( [Up] ) 
Down ( [ Down ] ) 
Sensitivity (50,35) 
Hysteresis (1,1) 
) 



; Button Definitions 

LB: Button (Keys ( [Enter ]) ) ;Left button 

MB: Button (Keys ( [Esc ]) ) ; Middle button 

RB: Button (Keys ( [Tab] ) ) ; Right button 



LM : Button ( Keys ( [ Home ] ) ) 

MR: Button (Keys ( [End] ) ) 

LR: Button (Keys( [&H0F00] ) ) 

LMR: Button (Keys ( [c-E] ) ) 



;Left + Middle 

; Middle + Right 

;Left + Right 

;Left + Middle + Right 



button 
button 

button (Shift-Tab) 

button (Ctrl-E) 



; Mouse Definition 

Mouse 
( 

Left (LB) 
Middle (MB) 
Right (RB) 
LeftMiddle (LM) 
MiddleRight (MR) 
LeftRight (LR) 
LeftMiddleRight (LMR) 
Cursor (Cursdef) ) 
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compile this menu source file (C:\MOUSE\M_IM.MSC) to create the menu definition file 



CD C:\MOUSE 
MSC MIM.MSC 

The following is a fragment of an AUTOEXEC.BAT file which automatically loads the mouse driver and 
installs the iceMASTER mouse menu (C:\MOUSE\M_IM.COM) created above: 

REM AUTOEXEC.BAT Fragment for Mouse Systems White Mouse: 

REM (Tested using Version 6.23 of the Mouse Driver) 
REM (Mouse Systems software files at "C:\MOUSE") 
REM 

REM 1 . Load Mouse Driver : 

REM (use 'C:\MOUSE\MSCMOUSE /AO' ' unaccelerated ' mouse on COMl) 

REM (use 'C:\MOUSE\MSCMOUSE 12 /AO' 'unaccelerated' mouse on COM2) 

C:\MOUSE\MSCMOUSE /2 /AO 
REM 

REM 2. Install iceMASTER Menu. 



REM 


iceMASTER menu files are C: 


\MOUSE\M 


IM.COM 


REM 


This menu defines the mouse buttons as follows: 


REM 


Movement : 








REM 


Left = Left 


arrow key 






REM 


Right = Right 


arrow key 






REM 


Up = up 


arrow key 






REM 


Down = Down 


arrow key 






REM 


Buttons : 








REM 


Left 




Enter 


key 


REM 


Middle 




Tab 


key 


REM 




Right = 


Esc 


key 


REM 


Left + Middle 




Home 


key 


REM 


Middle 


+ Right = 


End 


key 


REM 


Left 


+ Right = 


Shift-Tab key combination 


REM 


Left + Middle 


+ Right = 


Ctrl-E 


key combination 


REM 










REM 


C:\MOUSE\MOUSE.MSC 


is the raw source 


for the button/movement 



REM definitions. After creating C:\MOUSE\M_IM.MSC, type 

REM CD C:\MOUSE 

REM MSC M_IM.MSC 

REM to create the C:\MOUSE\M_IM.COM menu definition file. 

REM 

C:\MOUSE\POPUP /M:142 

C:\MOUSE\M_IM 

REM 

REM Later, to unload the mouse driver and menu: 
REM C:\MOUSE\MSCMOUSE /U 
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Appendix J: Command Line Options 



The emulator Host Software command line has the following form: 

ICE [option(s)] 

The command line options may be specified in any order and they are case-sensitive. 

To load a file into the emulator without having to configure the emulator and load a program as separate 
steps, simply include the name of the file you wish to load on the command line. For example: 

ICE FDEMOAOM 

will configure (Configure \ Emulator | Execute, page 7-2) the emulator and load (File \ Load, page 7-27) this 
file for immediate use. 

Other command line options include: 

-m {FILENAME.EXT} Use { FILENAME.EXT} as model file instead of 

$MODEL. 



-i { FILENAME.EXT } 



-b < num > 



Use {FILENAME.EXT} as macro file to execute. This 
macro input file must have been created during a previous 
debug session. 

Use {path} to locate High-Level Language (HLL) source 
files. If not specified 

Ignore local symbol debug records when loading a program 
file (absolute object module / load module). Debug records 
for global (public) symbols are still processed and the global 
symbols can be referenced symbolically from within the Host 
Software. This option is useful when the Host Software runs 
out of memory when loading a very large program with an 
extremely large number of debug records for local and global 
symbols. 

Disable testing (loading) of all possible video character sets 
(screen sizes) during Host Software initialization. The user 
must ensure that the PC is in some usable video mode when 
the Host Software is invoked, such as BIOS Video Mode 3 
(default for CGA, EGA, VGA). This option is provided for 
some video boards which evidently are not 100% Video 
BIOS compatible. 

In the absence of a SCONFIG file, set the default initial baud 
rate as follows: 

-bO 115200 {default} 

-bl 57600 

-b2 38400 

-b3 28800 

-b4 19200 

-b5 9600 
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-hxyz This option gives users some control over the mechanisms 

used by the Host Software in determining the beginning and 
ending addresses for each module in a program. This 
information is not recorded explicitly in an AOMF 
(Absolute Object Module Format) file, but must be derived 
by the Host Software when the program is loaded into the 
emulator. The Host Software, using several different kinds of 
information present in the AOMF file, attempts to do the 
best job of determining the module boundaries. However, 
due to movement of code segments/sections by the linker, or 
the presence of absolutely ORG'ed segments in an otherwise 
relocatable module, these attempts can cause the Host 
Software to "shorten" or "lengthen" or "lose" modules in the 
user's program. Note that when this happens, the ONLY side 
effects are that source line images may not be found for a 
particular module (due to truncation of the debug line 
number table) or the 'current module' (reported in various 
contexts) may not be correct. The actual code stream image 
seen and processed by the emulator is correct and all 
symbols, both global and local, in the AOMF file are 
available to the Host Software and have the correct 
addresses associated with them. Note that 'x", y and 'z' may 
be either '0' (don't use) or '1' (use), as follows: 

x Use min/max code text initialization addresses from 

each module. 

y Use min/max source line number addresses from 

each module. 

z Use min/max code label (local or global) addresses 

from each module. 

The default is '-hill': Use all three pieces of information in 
determining the minimum and maximum addresses for each 
module. You may see better results for some programs with: 

hOlO (Use only min/max source line number 
addresses in determining the beginning and ending 
addresses for each module). 

or 

hllO (Use both min/max code label addresses and 
min/max source line number addresses in 
determining the beginning and ending addresses for 
each module). 

-d < ms > Set the macro playback delay between keystrokes to < ms > 

milliseconds. To be used in conjunction with the '«? 
command line argument. 

-n Forces interpretation of the 'blink' video attribute bit to 

mean "intensify the background color". Effectively, this 
allows use of 16 background colors rather than the normal 8. 
This option should be specified only when the PC has an 
EGA/VGA adapter installed, attached to an EGA/VGA 
monitor. Normally, the Host Software automatically 
determines how to interpret the 'blink' bit, based on the 
adapter and monitor installed in the system. However, 
sometimes the Software can get "fooled". This option 
provides an absolute override. 
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-o Forces interpretation of the 'blink' video attribute bit to 

mean "blink the foreground character". This option should 
be specified when the PC has a Monochrome or CGA 
adapter installed, attached to a monochrome or CGA 
monitor. Normally, the Host Software automatically 
determines how to interpret the 'blink' bit, based on the 
adapter and monitor installed in the system. However, 
sometimes the Software can get "fooled". This option 
provides an absolute override. 

-q Create a command chart (included in Appendix O, the 

Command Chart). The command chart is written to the file 
CRQ_51.TXT. 

-qv Create a "verbose" command and Help Topic reference. The 

output is written to the file CRQV_51.TXT. 

When running under DOS, the forward slash, 7 ', may also be used as the option/argument indicator 
(instead of the dash, '-'). 
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Appendix K: Host Software Files 



iceMASTER Host Software System Files 



The Host Software executable file is: 

ICE.EXE 

The ICE.EXE file is the core of the Host Software system. Executing it brings the user into the Host 
Software environment. The ICE.EXE file is distributed on the distribution diskette labeled Host Soft- 
ware. 

The following files are read and/or written by the Host Software in order to configure various parts of the 
Host Software environment. When the Host Software attempts to open these files, it searches the 
following locations, in this order: 

1) The current directory. 

2) The paths you have defined within the DOS APPEND statement. 

3) The path specified by the EHSFP (Emulator Host Software File Path) environment variable (see 
AUTOEXEC.BAT in DOS Information appendix). 

A short description of each system file follows: 

SALERT Optional File: Yes 

Usage: The SALERT file contains the Alert options settings specified in the Configure \ Options screen 
(page 7-21). The SALERT file is read during Host Software initialization and when the Configure \ Restore 
command (page 7-26) is selected. 

How Created: The SALERT file is created, or rewritten, whenever the Configure \ Save \ Save command 
(page 7-25) is selected. The SALERT file is a binary file and must not be modified. 

SCLR1S Optional File: Yes 

Usage: The SCLRlS file contains the default color and video attribute settings suitable for CGA monitors. 
The SCLRlS file is read by the Host Software during video initialization if there is no SCOLOR file and 
the monitor type is a CGA. The SCLRlS file is read unconditionally if the Configure ^tri- 
butes | CGA/EGA/VGA Default command (page 7-8) is selected. 

■ 

How Created: The SCLRlS file is supplied as part of the Host Software system and will never be written 
to by the Host Software. The SCLRlS file is a binary file and must not be modified. 

$CLR2$ Optional File: Yes 

Usage: The SCLR2S file contains the default color and video attribute settings suitable for EGA/VGA 
monitors. The SCLR2S file is read by the Host Software during video initialization if there is no SCOLOR 
file and the monitor type is an EGA or VGA. The SCLR2S file is read unconditionally if the Configure At- 
tributes \EGA/VGA Default command (page 7-8) is selected. 

How Created: The SCLR2S file is supplied as part of the Host Software system and will never be written 
to by the Host Software. The SCLR2S file is a binary file and must not be modified. 
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$CLRM$ 



Optional File: Yes 



SCOLOR 



SCONFIG 



Usage: The $CLRM$ file contains the default color and video attribute settings suitable for Monochrome 
monitors. The $CLRM$ file is read by the Host Software during video initialization if there is no $COLOR 
file and the monitor type is a Monochrome. The $CLRM$ file is read unconditionally if the Configure {At- 
tributes {Monochrome Default command (page 7-8) is selected. 

How Created: The $CLRM$ file is supplied as part of the Host Software system and will never be written 
to by the Host Software. The $CLR1$ file is a binary file and must not be modified. 



$CODMEM$ Optional File: Yes 



Usage: The $CODMEM$ file is a temporary (scratch) file which contains the raw, binary image of code 
memory currently in the emulator. It is used to nunimize memory consumption within the Host Computer 
and to speed processing during complex break evaluation. 

How Created: The $CODMEM$ file is created during Host Software initialization and is read and written 
during many Host Software operations. 

Optional File: Yes 

If the $COLOR file does not exist, the Host Software will use default colors and video attributes, based 
on the monitor type (monochrome or color). 

Usage: The $COLOR file is read by the Host Software during its one-time initialization sequence, or when 
you execute the Configure {Restore command (page 7-26) or Configure {Attributes { User command (page 
7-9). The $COLOR file contains the user-specified color and video attribute settings to be used by the 
Host Software. 



How Created: The SCOLOR file is created, or rewritten, only when the user saves the current color and 
video attribute settings with the Configure \ Save \ Save command (page 7-25). The SCOLOR file is a binary 
file and must not be edited directly. 

Optional File: Yes 

If the SCONFIG file does not exist, the Host Software will use default configuration settings when 
establishing communication with the emulator base. 

Usage: The SCONFIG file is read by the Host Software during its one-time initialization sequence, and 
whenever the emulator must be configured. The SCONFIG file contains an encoding of: 



1) the baud rate to be used in communication between the Host Software and the emulator base (see 
Configure {Emulator{Baud rate, page 7-3) 

2) the RS-232 communication port to be used in communication between the Host Software and the 
emulator base (see Configure { Emulator {Comm port, page 7-3) 

3) the current "chip mode of operation" (see Configure {Emulator {Mode, page 7-2) 



How Created: The SCONFIG file is created, or rewritten, whenever any of the following commands are 
selected: 



Configure \ Emulator { Mode 



Irate 



Configure {Emulator \ Comm port 
The SCONFIG file is a binary file and must not be edited directly. 
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SFKEYDEF 



Optional File: Yes 



If the SFKEYDEF file does not exist, the Host Software will use default Function Key (Hot Key) settings 
and will display the default number (2) of Function Key label lines at the bottom of the screen. 

Usage: The $FKEYDEF file is read by the Host Software during its one-time initialization sequence, or 
when the Configure \Restore command (page 7-26) is selected. The $FKEYDEF file contains an encoding 
of: 



$LINE 



SMISC 



SMODEL 



$TRDAT$ 



$WINDOW 



1) the 40 Function Key assignments 

2) the number of Function Key label lines displayed at the bottom of the screen. 

How Created: The $FKEYDEF file is created, or rewritten, whenever the Configure \ Save \ Save com- 
mand (page 7-25) is issued. The SFKEYDEF file is a binary file and must not be edited directly. 

Optional File: Yes 

If the $LINE file does not exist, the Host Software will use the default screen size. 

Usage: The $LINE file is read by the Host Software during its one-time initialization sequence. The 
$LINE file contains an encoding of the screen size (video mode). 

How Created: The $LINE file is created, or rewritten, whenever the Configure \ Save \ Save command 
(page 7-25) is issued. The $LINE file is a binary file and must not be edited directly. 

Optional File: Yes 

Usage: The $MISC file contains the Miscellaneous options settings specified in the Configure \ Options 
Pull-down Menu (page 7-21). The SMISC file is read during Host Software initialization and when the 
Configure \ Restore command (page 7-26) is selected. 

How Created: The $MISC file is created, or rewritten, whenever the Configure \Save\ Save command 
(page 7-25) is executed. The SMISC file is a binary file and must not be modified. 

Optional File: No 

Usage: The SMODEL file is read by the Host Software during its one-time initialization sequence. The 
SMODEL file defines the operational properties of the particular probe card being used. The SMODEL 
file also specifies the settings for several user-configurable aspects of the Host Software's operating 
environment. The SMODEL file also contains the Help information. 

How Created: The SMODEL file is created by using the MF_GEN.EXE utility program distributed with 
the files on the Probe Card Software distribution diskette. After creation, the SMODEL file may be 
modified by using any text editor. The SMODEL file is a simple ASCII text file. See Appendix M, Model 
File Configuration for a description of those directives (lines) in the SMODEL file which may be 
modified. 

Optional File: Yes 

Usage: The STRDATS file is a temporary (scratch) file which contains the raw, binary image of the current 
trace buffer. It is used to minimize memory consumption within the Host Computer and to speed 
processing during trace buffer decoding. 

How Created: The STRDATS file is created during Host Software initialization. 
Optional File: Yes 
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Usage: The $WINDOW file contains the current window definitions (size and position) of the Main 
Screen windows and other windows capable of being sized or moved. The SWINDO W file is read during 
Host Software initialization and when the Configure | Restore command (page 7-26) is selected. 

How Created: The SWINDO W file is created, or rewritten, whenever the Configure [Save \Save command 
(page 7-25) is selected. The SWINDOW file is a binary file and must not be modified. 

Host Software File Organization 



If you have more than one emulator, consider making separate and easily recognized directories for each 
emulator. For example, if you have both an iceMASTER emulator and a MicroICE + emulator, you might 
lay out the directory structure as follows: 



(other directories) 



ROOT 



IM51 (for iceMASTER) 



MIP51 (for MicroICE+) 




Do Not Mix Files From Different Emulators 
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Appendix L: DOS Information 



Host Computer Environment Settings 



In order for the Host Computer to properly execute the Host Software system commands, the user must 
configure the DOS environment properly. The important files are: 

CONFIG.SYS 



The important parameters for the file CONFIG.SYS are the number of files that can be open at any one 
time (FILES = XX) and the number of buffers available to the system (BUFFERS = XX). Setting both of 
these parameters to at least 20 is acceptable for iceMASTER unless there are other applications that 
recommend a setting of more that 20. The CONFIG.SYS file may also have other specifications for the 
Host Computer environment, including SHELL, DEVICE, and BREAK. Consult the DOS reference 
manual (as well as the manuals for other applications that will be running on the Host Computer) for 
details on these parameters. 

A typical DOS 4.01 CONFIG.SYS file might read: 

REM Example CONFIG.SYS file for DOS Version 4.01: 

BREAK=ON 

BUFFERS=20 

FILES=2 

REM Increase environment size to 2048 (2K) bytes: 
SHELL=C : \DOS4 l\COMMAND . COM /P /MSG /E:2048 
REM Use the DOS 4. 01 ANSI. SYS Display Device Driver: 
DEVICE=C:\DOS401\ANSI.SYS /X 

A typical DOS 3.30 CONFIG.SYS file might be: 

REM Example CONFIG.SYS file for DOS Version 3.30: 

BREAK=ON 

BUFFERS=20 

FILES=2 

REM Increase environment size to 1048 (2K) bytes: 
Shell=C:\DOS330\COMMAND.COM /P /E:2048 

COMMAND.COM 



Several emulator Host Software commands (such as File | OS Escape) work by making DOS calls. In order 
to do this, a command processor must be available. The default command processor for DOS is 
COMMAND.COM. Another command processor can be specified using the SHELL command within 
CONFIG.SYS. Normally, the command processor resides in the root directory of the default drive, but if 
not the COMSPEC environment variable mus be set to point to the command processor. 

Note that changing the COMSPEC environment setting from its default setting may cause problems if not 
done properly. Consult the DOS Reference Manual for further information on the COMSPEC environ- 
ment variable. 
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AUTOEXEC.BAT 



The AUTOEXEC.BAT file is automatically executed by DOS each time the Host Computer is powered 
up or re-booted. 

Typically the PATH and EHSFP environment variables should be initialized in this file. A typical 
AUTOEXEC.BAT file, with comments, follows: 

REM Example AUTOEXEC.BAT file for DOS Version 4.01 when booting from 
hard drive ' C : ' : 
ECHO OFF 

REM Directory Information — 

REM C:\C51V2 Archimedes C-51 Version 2.0 
REM C:\DOS401 MS-DOS 4.01 files 

REM C:\F_C51 Franklin Software's 8051 c /Asm/Linker (newest version) 
REM C:\ICE MetaLink Host Software and associated files 
REM C:\IS Intel ASM-51, PL/M-51, RL51 

REM C:\MCCC Micro Computer Control Corp. 'mcc51' (MICRO/C-51) 

REM C:\MISC Miscellaneous Utilities/Files/Programs 

PATH C:\DOS401;C:\F_C51;C:\IS, -C:\C51V2, -C:\MCCC; \MISC; C : \ICE; C : \ 

REM EHSFP Emulator Host Software File Path 

SET EHSFP=C : \ ICE \ 

REM C_INCLUDE is for Archimedes 8051 C 
SET C_INCLUDE=C:\C51V2\ 

REM C51LIB is for Franklin Software 8051 C 
SET C51LIB=C:\F_C51 

REM : INCLUDE: is for Franklin Software 8 051 C 
SET INCLUDE :=C:\F_C51 

REM TMP is for Franklin Software 8051 c 
SET TMP=C:\C\TMP 

REM The COMSPEC variable specifies the location of thecommand processor 
REM (The default location, when booting from hard drive C:, is C:\COM- 
MAND.COM) : 

COMSPEC=C : \DOS4 1\ COMMAND . COM 

REM ANSI. SYS in DOS 4.0 now supports other than 25 line displays: 

MODE CON: LINES=43 

REM Display DOS Version Number: 

VER 

REM Analyze disk directory and file allocation table for consistency 

and report any errors: 

CHKDSK 

REM Display current date and time without requiring user intervention: 
PROMPT $d $t $g §echo off 

REM Using ANSI. SYS commands, specify the screen colors and the format 
of the DOS prompt: 

REM 1) Display the DOS prompt in reverse video (black on white) 
REM $e [ 7m 

REM 2) Define the DOS prompt as the current drive and path, followed by 
a greater-than sign: 

REM $p$g ($p = current drive and path, $g = character) 
REM 3) Set normal screen colors to white on a blue background: 
REM $e[37;44m(37 = white foreground, 44 = blue background) 
@ECHO ON 

PROMPT $e[7m$p$g$e[37;44m 
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You could use this AUTOEXEC.BAT file in DOS 3.30 as well, if the Mode command (DOS versions prior 
to 4.01 won't recognize the 'MODE CON: LINES: =43' statement) is removed. If you have named your 
DOS directory something besides "DOS401", be sure to use the path information that is valid for your 
drive. Refer to your DOS Reference Manual for more information. 

Editing DOS Files 



To build the CONFIG.SYS and AUTOEXEC.BAT files, there are several text editing methods. In 
general, any editor or word processor capable of editing a simple ASCII text (non-document) file can do 
the job. In addition, the DOS COPY command can use the DOS device CON: to build short files. The 
syntax is: 

COPY CON: FILENAM.EXT 
statement 1 
statement n 
~Z 

Therefore, the file CONFIG.SYS could be created by the following text, typed from the DOS command 
line: 

COPY CON: CONFIG.SYS 
FILES =20 
BUFFERS = 20 
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Appendix M: Model File Configuration 



$MODEL File Overview 

— ——————————— — — — — — — __ _____ _ , ; . 

The SMODEL file is a plain ASCII text file which may be edited using any text editor. The SMODEL file 
consists of a series of directives which control the behavior of the Host Software and the emulator. Only 
those directives listed in this appendix may be modified by you. All other directives in the SMODEL file 
must remain unchanged. 

WARNING: Any change to the SMODEL file other than those discussed here may result in erratic 
operation, or no operation at all. 

If you wish to change any of the following directives, we recommend that you first make a backup copy of 
the original SMODEL file. A new SMODEL file may be generated using the MF_GEN.EXE utility 
provided with the Probe Card Software distribution diskette. 

A11: SFR Display Sort Order 



This directive specifies the order in which the SFRs (Special Function Registers) will be displayed in the 
Register Window. The format of the All directive is: 

All {SFR_disp_sort_order}; 

where 

{SFR disp sort order} can be: 

display SFRs (left-to-right, top-to-bottom) in the order supplied in 
the Model File 

1 display SFRs (left-to-right, top-to-bottom) alphabetically (ASCII 
collating sequence) 

2 display SFRs (left-to-right, top-to-bottom) in increasing address 
order 

The default All directive is : 

All 0; #display SFRs (left-to-right, top-to-bottom) in the order supplied in the Model File 
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A36: Informative Messages During Program Load 



The format of the A36 directive is: 

Hpost-module-delay}; 



{post-file-delay} is the number of milliseconds to delay after (re) establishing 
the correspondence between entries in the Line Number Table and source 
images (file seek positions) for each module in the file currently loaded into 
code memory. This delay occurs after each 

Source Found For Name 

message is displayed. This allows the messages (if any) regarding the Host 
Software's ability to locate source images to remain on the screen long enough 
for you to read it. A value of indicates no delay. The maximum allowed value 
is 30000 (30 seconds). 

{post-module-delay} is the number of milliseconds to delay after 
(re) establishing the correspondence between entries in the Line Number 
Table and source images (file seek positions) for the last module in the file 
currently loaded into code memory. This additional delay occurs after the last 
message is displayed, or after the 

No Source Line Numbers Present 

or 

Source Line Numbers Present, but No Source Files Found 

message is displayed. This is done to allow the last message (if any) regarding 
the Host Software's ability to locate source images to remain on the screen 
long enough for you to read it. A value of indicates no delay. The maximum 
allowed value is 30000 (30 seconds). 

If both values are specified as zero (0), no messages are ever displayed and 
there is no delay. 

The default A36 directive is: 

A36 0; #Post-file delay = milliseconds 

0; #Post-module delay = milliseconds 

A40: Specify Method Of Updating (Writing To) Video Display 



The format of the A40 directive is: 

A40 {technique} {video RAM address override} {MBZ}; 



{technique} can be: 

(DEFAULT) Perform PC video display output by writing directly to 

video RAM. This option should be specified only when using PC's 
that are 100% IBM hardware compatible. This is the fastest 
technique. 



M-2 



If you have an older CGA video controller, you may notice some 
flickering in the display when this technique is used. The flickering 
can be eliminated by choosing Technique 1. The ANSI.SYS device 
driver may or may not be loaded, at your discretion, with no ill effects. 
For more information refer to {video_RAM_address_override} 
below. 

1 Perform PC video display output by using BIOS interrupts (only). 
This option should be specified when using PC's that are not 100% 
IBM hardware compatible, but that do have a 100% IBM compatible 
BIOS. This is the next fastest technique. The ANSI.SYS device driver 
may or may not be loaded, at your discretion, with no ill effects. 

2 Perform PC video display output by using (indirectly) DOS 
interrupts, via the internal C run-time library. This option should be 
specified when using PC's that are not 100% IBM hardware 
compatible and do not have a 100% IBM compatible BIOS. This is 
the slowest technique. 

When this technique is used with a color monitor and the device 
driver ANSI.SYS has been loaded, the colors in effect at the time the 
Host Software is invoked will "bleed through" into the display. 

{ video_RAM_address_override } 

The value in this field has meaning only when the video display 
{technique} above is (write directly to video RAM) and the value 
specified here is non zero. The Host Software automatically uses the 
following base addresses for video RAM: 

OxBOOO for a Monochrome Display Adapter 

0xB800 for a Color/EGA Display Adapter 

If your display adapter is set up to use a different address, then specify 
that address here. It should be in the form Oxhhhh where "hhhh" is the 
hexadecimal address of the base of the video RAM segment. 

{MBZ} 

Must Be Zero; reserved for future use. 

The default A40 directive is: 

A40 0x0000 0;#display video output by writing directly to video RAM 



A41: Control Formatting Of HLL Source Images 



The A41 directive specifies how HLL source images will be formatted for display in all contexts in the 
Host Software. The format of the A41 directive is: 

A41 {skip leading blanks} {tab_stop_setting}; 

where 

{ skip_leading_blanks } 

(DEFAULT) Do not skip (ignore) leading blanks when displaying 
HLL source images. 

1 Skip (ignore) leading blanks when displaying HLL source images. 

{tab_stop_setting} 

The tab stop value in this field can range from to 10. It specifies the 
tab stop setting (column width) to be used in processing ASCII 
horizontal tab characters (09 hexadecimal) in the HLL source 
images. The default value is 4. A value of means that ASCII 
horizontal tab characters will be ignored. A value of 1 means that each 
ASCII horizontal tab character will be replaced with a single blank. 

Note that for Intel PL/M-51 the {tab_stop_setting} value does not 
really apply to PL/M-51 modules. The PL/M-51 compiler expands all 
ASCII tab characters present in the source file into the appropriate 
number of blanks when generating the program listing (.LST) file. 
The Host Software obtains PL/M-51 source images from this '.LST' 
file. Therefore, the only way to retain the indentation reflected in the 
.LST file is to specify a {skip_leading_blanks} value of (which is the 
default meaning don't skip leading blanks). 

The default A41 directive is: 

A41 0; #HLL source display: leading blanks skip (l)/don't skip (0) 

4; #HLL source display: tab stops (column width) for ASCII TAB chars(O-lO) 

A42: Performance Analyzer Display Characters 



The A42 directive allows you to specify certain special characters used by the Performance Analyzer and 
to control other aspects of the Performance Analyzer's operation. The format of the A42 directive is: 

A42 {bar_blot_char} {file_bar_blot_char} 
{bar_half_blot_char } { file bar half blot char } 
{micro char} {file micro char} 
{vertbarchar} {file_vert_bar_char} 
{display mode}; 




The default A42 directive is: 



A42 0xDB 

'#' 

0x10 

'> >' 

0xE6 

V 

0xB3 



# 4% bar char (video display) 

# 4% bar char (when writing to file) 

# 2% bar char (video display) 

# 2% bar char (when writing to file) 

# "micro-" (mu) symbol (video display) 

# "micro-" (mu) symbol (when writing to file) 

# vertical line char (video display) 

# vertical line char (when writing to file) 

# in Symbolic and Mixed mode, display both Global & Local code labels 

# (0 = Globals & Locals, 1 = Globals only, 2 = Locals only) 



A43: Three Digit Separator 



The character specified here will be used as the separator between every third digit when displaying the 
real-time clock value in Main Status Window, the Performance Analyzer Emulation Window, and sample 
counts in the Performance Analyzer Emulation Window. 

The default A43 directive is: 

A43 ','; # Separator for every 3rd digit in time/count values. #Note, the Europeans separator is a pe 
riod. 

A49: RS232 Time-out Loop Count 



The format of the A49 directive is: 

A49 {normal time-out count} {short time-out count}; 

where 

{normal time-out count} 

sets the time-out limit for normal reception from, and transmission to, 
the emulator. Note that the number specified here is not an actual 
clock time value, but rather a count for the number of times the Host 
Software will execute (wait in) the innermost "wait for a byte to be 
received" or "wait for a byte to be transmitted" loop. The larger the 
number, the longer the time-out interval will be (i. e., the more times 
the Host Software will execute the inner most "wait" loop before 
declaring an actual time-out). Generally, faster Host Computers will 
require a larger number here; slower Host Computers can get by with 
a smaller number. Note that if the number here is too large and there 
actually is a communication failure problem, it will take a very long 
time for the Host Software to detect and report the problem. 

{Short time-out count} 

sets the time-out limit for the quick communication test routine which 
is used to detect a warm-start condition when the Host Software is 
first invoked. The larger the number specified here, the longer the 
Host Software will wait for a response from the emulator during the 
Host Software's one-time-initialization (only performed when the 
Host Software is first invoked). 

The default A49 directive is: 
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A49 5 #lst RS232 communication time-out limit (normal comm) 

4; #2nd RS232 communication time-out limit (warm-start comm test) 



A50: Data Type Display Modes 



The A50 directive is used to set the display mode for each data type when displaying HLL symbol values. 
Currently, the Franklin and Keil C compilers output C data information when the OBJECTEXTEND 
compilation option is activated. The format of the A50 directive is: 



where 



A50 {char dsply mode} {uchar_dsply_mode} 
{ int_dsply_mode } { uint_dsply_mode } 
{ long_dsply_mode } { ulong_dsply_mode } 
{ floatdsplymode } ; 

hex format 



character format 



The default A50 directive is: 



A50 # char default: hex 

# unsigned char default: hex 

1 # int default: decimal 

1 # unsigned int default: decimal 

1 # long default decimal 

1 # unsigned long default: decimal 

0; # float default: hex 
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Appendix N: Default Function Key Assignments 



Function Key 


Short Description 


Command Sequence 


Fl 


Help 


Help 


F2 


ResetEm 


Run | Reset \ Emulator 


F3 


ResetTg 


Run | Reset \ Target 


F4 


Go 


Run | Go 


F5 


GoFrom 


Run \From 


F6 


GoUntil 


Run | Until 


F7 


Steplns 


Run \Step 


F8 


StepLin 


Run \Line 


F9 


StepOvr 


Run | Over 


F10 


StepTo 


Run | To 


Shift-Fl 


Load 


File\Load 


Shift-F2 


SetBkpt 


Break/Trace | Set 


Shift-F3 


ViewTrc 


Break/Trace \ View Trace 


Shift-F4 


DisAssm 


Display/Alter \Asm/Dasm 


Shift-F5 


MacExec 


File | Macro \Execute 


Shift-F6 


CurMod 


Source /Symbols Current Module 


Shift-F7 


SrcPath 


Source /Symbols \ Source Path 


Shift-F8 


RawSrc 


Source /Symbols \Raw Source 


Shift-F9 


SymGlob 


Source/Symbols \ Global 


Shift-FlO 


SymAlph 


Source/ Symbols \Alpha 


Ctrl-Fl 


Modules 


Source /Symbols \Modules 


Ctrl-F2 


Scopes 


Source/Symbols \ Scopes 


Ctrl-F3 


LinNums 


Source/Symbols \Line Numbers 


Ctrl-F4 


SymLocl 


Source/Symbols \Local 


Ctrl-F5 


SymAddr 


Source/Symbols \Address 


Ctrl-F6 


WnModfy 


Configure | Windows \Modify 


Ctrl-F7 


WnResiz 


Configure \ Windows \ Size 


Ctrl-F8 


WnSelct 


Configure \ Windows \ Goto 


Ctrl-F9 


AddWtch 


Configure \ Windows \Add 


Ctrl-FlO 


DelWtch 


Configure \ Windows \ Delete 


Alt-Fl 


WnRepnt 


Configure \ Windows \Repaint 


Alt-F2 


MemCode 


Display /Alter \ Code 


Alt-F3 


Memldat 


Display /Alter \ Idata 


Alt-F4 


MemXdat 


Display/Alter \Xdata 


Alt-F5 


SymVwCh 


Display/Alter \ Var/Reg 


Alt-F6 


RAM Bit 


Display /Alter \ RAM-Bits 


Alt-F7 


GoSlow 


Run | Slow Motion 


Alt-F8 


RepCnt 


Run | Repetition Count 


Alt-F9 


HRes PA 


Misc \High Resolution 


Alt-FlO 


HBinPA 


Misc \High Bin Count 
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Appendix O: iceMASTER Command Chart 



A command chart is listed on the following pages. The command chart includes (in column order): 

1) Menu/Command Tree Structure 

2) Val - Default value (if applicable) 

3) H-Key - Default Hot Key (Function Key) assignment 

4) Lab - Short command description used for Function Key Labels at bottom of screen ('...' if not 
assignable to a Function Key) 

5) Menu/Command Description (copy of "Quick Help" line) 

Note that this command chart can be generated by invoking the Host Software using the '-q' command 
line option. If you reassign any Function Keys or change any default values, use the '-q' command line 
option to generate a new chart and replace the chart on the following pages. 
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Pull -Down Menu & Conmand Structure Reference for iceMASTER-8051 Host Software Version 3.0 Rev 12, $MODEL Version 3.014 (8052) 



Menu/Command Tree Structure 



Configure 

Emulator .. 
Execute 



■ ■•■■•■■■■* 



Mode 

Mode 1: ROMless (803X) Operation, /EA 

Mode 2: ROM (805X), /EA = High 

Comm port 

COM1 

COM2 

Baud rate 



Low 



All . 

En 
fa 



115200 
57600 
38400 
28800 
19200 
9600 . 
(Mapping) 
Code Memory 
Emulator 
Target . . 
All 

Emulator 
Target 
Load 

Save 

Xdata Memory 
Emulator 
Target .. 
All 

Emulator 
Target 
Load 

Save 

(Display) 

Attributes 

Lines 

25 

28 

43 

50 

(Colors) 

CGA/EGA/VGA Default 
EGA/VGA Default ... 
Monochrome Default 

User 

Select 

Windows 



Em 
la 



val(1) 



Mode 1 



COM1 
115200 



25 



H-Key(2) 



Lab(3) 



Menu/Command Description (copy of "Quick Help" line at bottom of screen) 




Set up the system configuration 
Configure the emulator 

Configure system according to current settings (shown here & saved in SCONFIG) 



Select probe card mode of operation (ROM, ROMless, etc.) 



Select RS-232 communication port 

Use C0M1 for communication between host PC and emulator base 
Use COM2 for communication between host PC and emulator base 
Select RS-232 communication baud rate (serial link speed) 



Display/ change Code memory mapping 

Map a block of code memory to the emulator 

Map a block of code memory to the target board 

Map all code memory menu 

Map all code memory to the emulator 

Map all code memory to the target board 

Load map configuration from a file 

Save current map configuration to a file 

Display/change External Data memory mapping 

Map a block of external data memory to the emulator 

Map a block of external data memory to the target board 

Map all external data memory menu 

Map all external data memory to the emulator 

Map all external data memory to the target board 

Load map configuration from a file 

Save current map configuration to a file 

Change video display parameters (e.g., colors and number of lines on screen) 

Set size of video display (number of lines) 

25-line display 

28- line display 

43- line display 

50- line display 

Set colors to supplied defaults suitable for CGA/EGA/VGA monitors (file $CLR1$) 

Set colors to supplied defaults suitable for EGA/VGA monitors (file $CLR2$) 

Set colors to supplied defaults suitable for monochrome monitors (file $CLRM$) 

Set video display colors to your default colors (file SCOLOR) 

Select all video display colors and attributes individually 

Change layout/size of main windows, "goto" a window & add/delete watches 
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Modify . 
Size ... 
Goto . . . 
Repaint 
(Watch) 
Add .... 
Delete . 



identification 

Options 

(Alert) 

Diagnostics 

Bad key/command 

Host -break 

(Miscel laneous) 

Flicker 

Trace prefetch 

Main Esc 

Common Window Borders . 

Stack Hyperlinks 

Prompt OS-Escape 

Unknown data type size 

Function -Keys 

Lines 

Modify 

Assign 

Clear 

Display 

Save 

Write 

Help 

Save 

Save 

(Save Opts) 

Alert 

Colors 

Function-Keys 

Lines 

Misc 

Windows 

Restore 

File 

Load 



Store .. 
Restore 



Upload .. 
Download 



Macro 

Execute 
Learn . . 
Delay .. 
Repeat . 



On 
On 
On 

On 
On 
On 
On 
On 
On 
1 



On 
On 
On 
On 
On 
On 



Ctrl-F6 
Ctrl-F7 
Ctrl-F8 
Alt-Fl 

Ctrl-F9 
Ctrl-F10 



Shift-F1 



Shift-F5 



WnModfy 
WnResiz 
WnSelct 
WnRepnt 

AddWtch 
DelWtch 



Load 



DownLod 



MacExec 



Modify individual window attributes (active, order, start address, misc options) 
Manually adjust the size of one or more windows on the main screen 
"Jump into" (select) a main screen window, to peruse and/or change data in it 
Repaint all windows on the main screen (e.g., to see changing register values) 

Add a watch variable to the Watch Window 

Delete (remove) a watch variable from the Watch Window 

Display software and hardware version/environment information 
View/change miscellaneous user interface configuration options 

Beep when a diagnostic message is issued 
Beep when an unrecognized key is pressed 

Beep at a Host-Break (i.e., when Esc key is pressed to halt emulation) 
Flicker response in "Yes/No" dialog boxes, etc. 

Automatically prefetch trace frames from emulator after each emulation cycle 

Pressing Esc key in Main Menu will prompt to exit Host Software 

Adjacent Main Screen Windows share a common bottom/top border 

Hyperlinks in 'Help' stack, allowing return to previous hyperlink topic 

During OS-Escape, augment DOS prompt with "...type 'exit' to return..." reminder 

Number of bytes to display for unknown data types in 'Source/Symbol' displays 

View/change current Function Key assignments & number of label lines displayed 

Specify number of Function Key label lines to be displayed at bottom of screen 

View/change current Function Key assignments 

Assign current option to current Function Key 

Clear assignment of current Function Key 

Toggle screen display mode 

Save Function Key assignments 

Write the Function Key assignments to an ASCII text file 
Help for Function Key Assignment Menu 

Save (change default value of) one or more user interface configuration options 
Save current user interface configuration parameters per 'Save Opts' settings 

Save current 'Alert' option settings into SALERT 

Save all current screen colors & other video attribute settings into SCOLOR 

Save all current Function Key specifications into SFKEYDEF 

Save current screen size (number of rows) into SL I NE 

Save current 'Miscellaneous' option settings into $MISC 

Save current window definitions (order, size, etc.) into SWINDOW 

Restore all saved user interface configuration options/parameters 

File operations 

Load program memory from a disk file (AOMF/.HEX/S- Record) 

Store current application environment in a disk file 
Restore application environment from a disk file 

Upload program memory from target system board 

Download target system board external data memory from a disk file 
Create or execute a macro command file 

Playback commands from a macro disk file (created using 'Learn' command below) 
Enter learn mode, "remembering" keystrokes into a macro disk file 
Set delay between keystrokes during macro execution (units: 1/1000th second) 
Set macro execution (playback) repeat count 
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OS Escape 



Run 



Reset 

Processor 



Emulator 
Target . 
(Go) 

Go 

From 

Until 

Slow Motion 
(Step) 

Step 

Line 

Over 

To 



Repetition Count 

Display/Alter 

Asm/Dasm 

Disassemble .. 

Assemble 

Mode 

Label -synch .. 

Write 

(Memory) 

Code 

Browse 

Fill 

Move 

Compare 

Write 

Dump 

Hex 

S-Record . . 

Idata 7 

Browse 

Fill 

Move 

Compare 

Write 

Xdata 

Browse 

Fill 

Move 

Compare 

Write 
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Var/Reg . 

RAM-Bits 
Misc 



EMM Usage 



Shift-F4 DisAssm 



...... 



Alt-0 



F2 
F3 

F4 
F5 
F6 

Alt-F7 

F7 
F8 
F9 
F10 

AU-F8 



AU-F2 



AU-F3 



AU-F4 



Alt-F5 
AU-F6 







OS-Esc 
Exit 



ResetPr 

ResetEm 
ResetTg 

Go 

GoFrom 

GoUntil 

GoSlow 

Steplns 
StepLin 
StepOvr 
StepTo 

RepCnt 



MemCode 



Memldat 



MemXdat 



SymVwCh 
RAM Bit 



Temporarily escape to DOS -- type 'exit' to r 

exit to DOS) 



here 



Terminate host software (quit; 
Begin emulation 

Reset the MCS-51 processor in the probe card, optionally beginning emulation 
Reset the processor (chip) in the probe card, but do not begin emulation 

Begin emulation from RESET conditions (RESET signal supplied by emulator base) 
Begin emulation from RESET conditions (RESET signal supplied by target system) 

Begin (resume) emulation at current PC 

Begin (resume) emulation, specifying a new PC value 

Begin (resume) emulation at current PC, specifying a temporary break-point 

Begin (resume) emulation at current PC in variable-speed "slow motion" mode 

Single-step from one machine instruction to the next 
Single-step by source line number (across all modules in program) 
Single-step by source line (within current module only: "step over" calls) 
Single-step to procedure/function entry points (global/public code labels) 

Number of automatic "Go" or "Step" repeats of next Reset -/Go-/Step- type command 
Display/Alter memory 

Patch instructions into Code memory or view memory as disassembled instructions 
Disassemble code memory bytes 

Assemble instructions into code memory (patch code memory with new instructions) 

Toggle display mode between Code (instrs only) and Mixed (instrs + HLL images) 
Toggle disassembly label-synchronization on/off 
Write disassembled code to a file, using current display mode 

View/change/fill/move/compare/write Code memory in hex & ASCII 

View/Change Code memory 

Fill a block of Code memory 

Move (copy) a block of Code memory 

Compare two blocks of Code memory 

Write Code memory to disk in various formats 

Write Code memory to a file in 'dump 1 (human-readable) format 

Write Code memory to a file in Intel Standard Hex format 

Write Code memory to a file in Motorola S-Record format 

View/change/fill/move/compare/write Internal Data memory in hex & ASCII 

View/Change Internal Data memory 

Fill a block of Internal Data memory 

Move (copy) a block of Internal Data memory 

Compare two blocks of Internal Data memory 

Write a block of Internal Data memory to a disk file in human- readable form 

View/change/f i I l/move/compare/wri te External Data memory in hex & ASCII 

View/Change External Data memory 

Fill a block of External Data memory 

Move (copy) a block of External Data memory 

Compare two blocks of External Data memory 

Write a block of External Data memory to a disk file in human- readable form 

View/change, by name, the value assigned to any variable, register or bit 

View/change individual bits in the bit-addressable internal Bit Memory space 
Miscellaneous capabilities 
Display usage of Expanded Memory 



PROM Programmer 



A-to-D Converter 

Multiply-Divide Unit .. 

OPTRs (multiple) 

FIFO 

(Performance Analyzer) 

High Resolution 

Statistics 

Clear 

Accumulate 

View 

Raw 

Symbolic 

HLL 

Mixed 

Counts 

Expand 



Masses 

Write 

Help. 

Run 

Reset (emulator) 
Reset (target) .. 

Go 

Quick-setup 

Bins 

(Setup Types) 

N- equal 

Module 

Procedure 

Line numbers 

Misc 

Clear 

Sort Order 

Capture Span 

Edit 

Add 

Delete 

File 
Save 
Load 
High Bin Count 

Statistics 

Clear 

Accumulate . 

View 

Raw 

Symbo I i c 

HLL 

Mixed ... 
Counts . . 
Expand . . 
Masses . . 
Write ... 



rue 

Sa 
I LO 



Off 



RANGE 



Off 



Alt-F9 



AU-F10 



HRes PA 



HBin PA 



Program and test '751/'752 PROMs 

Display values in A-to-D Converter registers 

Display values in Multiply-Divide Unit (MDU) registers (as int or unsigned int) 
Display values in each of the DPTRn registers 
Display values in the FIFO 

High resolution performance analysis (program profiling) 

Performance Analyzer statistics options 

Clear performance analysis statistics 

Accumulate performance analysis statistics toggle 

View performance analysis statistics (post-emulation) 

Display Mode: bar graph lines only (one per bin) 

Display Mode: bar graph lines + all labels (global and/or local) in range 

Display Mode: bar graph lines + HLL source images/lines in ranges in bin 

Display Mode: bar graph lines + labels + HLL source images (Symbolic + HLL) 

Toggle bar graph lines to/from actual bin sample counts 

Toggle to/from additional information for each range in each bin 

Toggle to/from accumulating Miss Bin count in total sample count and percentages 

Write performance analysis results to a disk file (in current display mode) 

Get help information for the Performance Analyzer display menu 

Run Performance Analysis 

Begin performance analysis from RESET conditions (RESET supplied by emulator) 

Begin performance analysis from RESET conditions (RESET supplied by target) 

Begin (resume) performance analysis at current PC 

Quick Performance Analyzer setups 

Set the number of bins to be used for a Quick-Setup 

Create 'N' (14) equally sized bins 

Create bins using module addresses 

Create bins using procedure/function addresses 

Create bins using source code line number addresses 

Miscellaneous setup options 

Clear performance analyzer setup 

Toggle the displayed sort order 

Specify the code memory capture span 

Edit current bin 

Add a bin to Performance Analyzer setup 

Delete the current bin from Performance Analyzer setup 

Save or Load a Performance Analyzer setup 

Save Performance Analyzer setup to a file 

Load Performance Analyzer setup from a file 

High maximum bin count performance analysis (program profiling) 

Performance Analyzer statistics options 

Clear performance analysis statistics 

Accumulate performance analysis statistics toggle 

View performance analysis statistics (post-emulation) 

Display Mode: bar graph lines only (one per bin) 

Display Mode: bar graph lines + all labels (global and/or local) in range 

Display Mode: bar graph lines + HLL source images/lines in ranges in bin 

Display Mode: bar graph lines + labels + HLL source images (Symbolic + HLL) 

Toggle bar graph lines to/from actual bin sample counts 

Toggle to/from additional information for each range in each bin 

Toggle to/from accumulating Miss Bin count in total sample count and percentages 

Write performance analysis results to a disk file (in current display mode) 



Helg 



I I 

Run 

Reset (emulator) 
Reset (target) .. 
Go 



Quick -setup 
Bins 



(Setup Types) 

N-equal 

Module 

Procedure 

Line numbers . 

Misc 

Clear 

Sort Order ... 
Capture Span . 

Edit 

Add 

Delete 

File 
Save 
Load 

Source/Symbols 
Module Update . 

Auto 

User 

Current Module 
Source Path . . . 



r i le 

Sa 



Raw Source . 
(Structure) 

Modules 

Scopes 

Line Numbers 
(Symbols) 

Global 

L oca I 

Alpha 

Address 

Break/Trace 

Set 

Add 

CBREAK 
XBREAK 
TRON: 
TROFF: 

Remove 

Edit 

Hex 

Sytnbo lie ... 
Opcode_Class 

Add 

Remove . . 
Edit 
Name 
Mnemonic 



Code Break-Point 

External Data Break-Point 

Trace-On-Point 

Trace-Off -Point 



tail 

Na 
I Mn 



RANGE 



AUTO 



Shift-F6 
Shift-F7 

Shift-Fa 

Ctrl-F1 
Ctrl-F2 
Ctrl-F3 

Shif t-F9 
Ctrl-F4 
Shif t-FlO 
Ctrl-F5 



Shift-F2 



CurMod 
SrcPath 

RawSrc 

Modules 

Scopes 

LinNums 

SymGlob 
SymLocl 
SymAlph 
SymAddr 



SetBkpt 



Get help information for the Performance Analyzer display menu 
Run Performance Analysis 

Begin performance analysis from RESET conditions (RESET supplied by emulator) 

Begin performance analysis from RESET conditions (RESET supplied by target) 

Begin (resume) performance analysis at current PC 

Quick Performance Analyzer setups 

Set the number of bins to be used for a Quick-Setup 

Create 'N' (14) equally sized bins 

Create bins using module addresses 

Create bins using procedure/function addresses 

Create bins using source code line number addresses 

Miscellaneous setup options 

Clear performance analyzer setup 

Toggle the displayed sort order 

Specify the code memory capture span 

Edit current bin 

Add a bin to Performance Analyzer setup 

Delete the current bin from Performance Analyzer setup 

Save or Load a Performance Analyzer setup pulldown 

Save Performance Analyzer setup to a file 

Load Performance Analyzer setup from a file 

Source level debug and symbol displays 

Modify current module update mode 

Set current module automatically 

Specify the current module manually 

Specify the current module manually 

View/change the path used for locating HLL source/ listing files 

View the raw source for a C module or the listing file for a PL/M-51 module 

Display the list of modules in the program 
Display the scopes in the program 

Display the tine numbers available for (defined in) the program file 

Global (PUBLIC) symbol information, sorted alphabetically 

Local symbol information, sorted alphabetically 

Both global and local symbol information, sorted alphabetically 

Global and local symbol information, sorted by address within each memory space 

Modify break-/trace-points; view trace buffer 

Set simple & complex Break-Points and Trace-Points 

Add a break element 

Add a Code Break-Point element 

Add an External Data Break-Point element 

Add a Trace-On-Point element 

Add a Trace-Off -Point element 

Remove highlighted break element 

Edit highlighted break element 

Change the display mode to Hexadecimal 

Change the display mode to Symbolic 

View/Modify opcode classes 

Add an opcode class element 

Remove the current opcode class element 

Edit the current opcode class element 

Name opcode class 

Choose opcode mnemonic 



0-6 



Operand 2 ■ • 

None 

Immediate 
Direct .. 

Bit 

/Bit 

Code 

A 

C 

DPTR 

PC 

AB 

3R0 

am 

Rn 

RO ... 
R1 ... 
R2 ... 
R3 ... 
R4 ... 
R5 ... 
R6 ... 
R7 ... 
RO 

Operand 2 . . 

None . 

Immediate 
Direct .. 

Bit 

/Bit 

Code 

A 

C 

DPTR 

PC 

AB 

aRO 

3R1 

Rn 



- R7 



RO 
R1 
R2 
R3 
RA 
R5 
R6 
R7 
RO 



- R7 



Load 
Save 
Load . . . 
Save . . . 

Clear 

D isable . . . 
Enable 



CI rBrks 
DisBrks 
EnaBrks 



Choose operand 1 (destination) 
No operand 

Select immediate operand 

Select direct operand 

Select bit operand 

Select complemented bit operand 

Select code address operand 

Select accumulator operand 

Select carry bit operand 

Select data pointer operand 

Select PC operand 

Select AB pair operand 

Select indirect register operand 

Select indirect register 1 operand 

Select register pulldown 

Select register operand 

Select register 1 operand 

Select register 2 operand 

Select register 3 operand 

Select register 4 operand 

Select register 5 operand 

Select register 6 operand 

Select register 7 operand 

Select register through 7 operand 

Choose operand 2 (source) 

No operand 

Select immediate operand 

Select direct operand 

Select bit operand 

Select complemented bit operand 

Select code address operand 

Select accumulator operand 

Select carry bit operand 

Select data pointer operand 

Select PC operand 

Select AB pair operand 

Select indirect register operand 

Select indirect register 1 operand 

Select register pulldown 

Select register operand 

Select register 1 operand 



Select register 

Select register 

Select register 

Select register 

Select register 

Select register 



operand 
operand 
operand 
operand 
operand 
operand 



Select register through 7 operand 

Load opcode class from file 

Save opcode class to file 

Load break elements from a disk file 

Save break elements to a disk file 

Clear (permanently remove) all simple & complex Break-Points and Trace-Points 

Temporarily remove all simple & complex Break-Points and Trace-Points 

Restore Break-/Trace-Points temporarily removed by the 'Disable' command above 



Trace Trigger 

Start 

Center 

End 

Variable .. 
Break-Count .. 



View Trace 

Raw 

Code . . . 
Mixed .. 

HLL 

Probes . 
Search . 
Write .. 



Help 





(1) : Default value (if applicable) 

(2) : Default Hot Key (Function Key) assignment 

(3) : Function Key bottom-of -screen label ("..." 



End 



+0 





Shif t-F3 



BrkCnt 



ViewTrc 



Specify when emulation stops, relative to actual break-point, in terms of trace 
Emulation stops after 4K trace frames accumulate following break-point 
Emulation stops after 2K trace frames accumulate following break-point 
Emulation stops as soon as the first break-point is reached 
Emulation stops after 'n' trace frames accumulate following break-point 
Specify number of break-points to pass through before actually breaking 

View the contents of the trace buffer 

Raw display mode: show trace frame content as address, data and probe 
Code display mode: show trace frame content as disassembled instructions 
Mixed display mode: disassembled instructions with HLL source interspersed 
HLL display mode: show trace frame content as HLL (C or PL/M-51) source lines 
Toggle 'Probes' column between binary, hex & digital waveform display modes 
Search trace buffer for a specific code memory address or trace frame number 
Write trace buffer data to a file (using current display mode) 
Information on various topics 



if command is not assignable to a 



Function Key) 



0-8 



Index 



i 

SALERT, K-l 
SCLR1S, K-l 
SCLR2S, K-l 
SCLRMS, K-2 
SCODMEMS, K-2 
SCOLOR K-2 
SCONFIG, K-2 
SFKEYDEF, K-3 
SLINE, K-3 
SMISC, K-3 
SMODEL, K-3 
STRDATS, K-3 
SWINDOW, K-3 
8031 

Jumper Settings, 4-2 
8032 

Jumper Settings, 4-2 
803X 

Clock Jumper Map, 4^*2 
8052 

Jumper Settings, 4-4 
Mapping Constraints, 4-5 
Modes, 4-5 
805X 

Clock Jumper Map, 4-43 
80C154 

Jumper Settings, 4-2 
80C321 

Jumper Settings, 4-2 

Modes, 4-3 
80C451 

Jumper Settings, 4-10 
80C515 

Mapping Constraints, 4-17 

Modes, 4-17 
80C517 

Jumper Settings, 4-14 

Mapping Constraints, 4-17 

Modes, 4-17 
80C51FA 

Jumper Settings, 4-2 
80C521 

Jumper Settings, 4-18 

Modes, 4-19 
80C532 

Jumper Settings, 4-20 
80C535 

Jumper Settings, 4-20 

Modes, 4-22 
80C537 

Jumper Settings, 4-24 

Modes, 4-26 
80C552 

Jumper Settings, 4-32 
80C652 

Jumper Settings, 4-2 
80C851 

Jumper Settings, 4-2 
80CL410 

Jumper Settings, 4-2 
8344 



Jumper Settings, 4-2 
83C053 

Jumper Settings, 4-6 
83C152 

Jumper Settings, 4-8 

Mapping Constraints, 4-9 

Modes, 4-9 
83C451 

Jumper Settings, 4-12 

Mapping Constraints, 4-13 

Modes, 4-13 
83C550 

Jumper Settings, 4-28 

Mapping Constraints, 4-30 

Modes, 4-30 
83C552 

Jumper Settings, 4-34 

Mapping Constraints, 4-36 

Modes, 4-36 
83C652 

Jumper Settings, 4-34 
83C654 

Jumper Settings, 4-34 
83C751 

Jumper Settings, 4-38 
83C752 

Jumper Settings, 4-40 
\RD, 8-2 
\WR 8-2 

A 

Active LED, 3-5 

Not Lit, 9-1 
Alert Options 

Save Toggle, 7-25 
Analog To Digital Converter, 7-41 
Assembler Options 

Archimedes, H-l 

Franklin, H-l 

Intel, H-2 

MetaLink, H-3 

Tasking, H-4 
AUTOEXEC.BAT, L-2 
Automatic Module Update, 7-52 

B 

Baud Rate, 7-3 

Command Line Option, J-l 
Beep 

Bad Key/Command Toggle, 7-21 
Diagnostics Toggle, 7-21 
Host-break Toggle, 7-21 

Bin Capture Range, 7-43 

Bin Description, 7-44 

Bin Number, 7^»3 

Bit Window, 7-14 

Blink Attribute To Blink 

Command Line Option, J-3 

Blink Attribute To Bold 



Command Line Option, 3-2 
Break 

Add, 7-58 
Code, 7-58 
Edit, 7-59 

External Data, 7-58 

Hex Display, 7-60 

Remove, 7-59 

Symbolic Display, 7-60 

TROFF, 7-58 

TRON, 7-58 
Break Address Indicator, 7-16 
Break Bin, 7-43 
Break LED, 3-5 
Break Push-button, 3-4 
Break-Count, 7-64 
Break-Count Indicator, 7-16 
Breaks 

Clear, 7-63 

Disable, 7-63 

Enable, 7-63 

Load From File, 7-63 

Save To File, 7-63 



Local Automatic Variables, E-l 

Source File Naming, G-2 
C Characteristics 

Archimedes, G-3 

Franklin, G-3 

MCC, G-6 
C Compilation Options 

Archimedes, H-l 

BSO/Tasking, H-4 

Franklin, H-l 

MCC, H-3 
CGA 

Default Display Attributes And Colors, 7-8 

Screen Size, 7-8 
Change Mode, 6-6 

Active Keys, 6-6 

Entering, 6-6 
Clock Drivers, 8-2 
Code Memory 

Assemble, 7-37 

Browse Mode, 7-38 

Compare Blocks, 7-39 

Disassemble, 7-36 

Fill, 7-38 

Map To Emulator, 7 A 

Map To Target, 7-4 

Move Block, 7-39 

Write Disassembly, 7-38 

Write Dump, 7-39 

Write Hex Format, 7-39 

Write S-Record Format, 1A0 
Code Window, 7-15 
Color Palette, 7-10 
Colors 

Save Toggle, 7-25 
Command Chart 

Command Line Option, J-3 

Layout, O-l 
Command Chart With Help 

Command Line Option, J-3 
COMMAND.COM, 6-8, L-l 
Common Window Borders Toggle, 7-22 



Communication Failure, 9-2 

Communication Port, 7-3 

Complex Break, 7-57 
Code Address, 7-59 
Direct Address, 7-59 
Bit Address, 7-59 
Immediate Operand, 7-60 
NULL, 7-58 
Opcode Class, 7-60 
Opcode Range, 7-59 

CONFIG.SYS, L-l 

Configuration 
Restore, 7-26 
Save, 7-25 

Confirmation Box, 6-3 

Current Module, 7-52 



Data Type 

Display Modes, M-6 
Diagnostic Message Box, 6-3 
Dialog Box, 6-3 

editing keys, 6-3 

Filename, 6-7 
Directory Listing, 6-8 
Disable Video Testing 

Command Line Option, J-l 
DOS Prompt, 7-22 
DPTR 

Multiple, 7-42 
DPTR Indicator, 7-16 
Dynamically Annotates Code, 6-5 



EGA 

Default Display Attributes And Colors, 7-8 

Screen Size, 7-8 
EHSFP Variable, L-2 
Emulate LED, 3-5 
Emulation 

Stand Alone Operation, 2-2, 3-1 
Emulation Environment 

Restore, 7-28 

Store, 7-28 
Emulator Base Type, 7-20 
Emulator Memory Installed, 7-20 
Establish Communication, 7-2 
Execution Time Indicator, 7-16 
Exit, 7-21, 7-32 
Expanded Memory, 7-41 
External Data Memory 

Browse Mode, 7-38 

Compare Blocks, 7-39 

Fill, 7-38 

Map To Emulator, 7-6 
Map To Target, 7-6 
Move Block, 7-39 
Write Dump, 7-39 
External Data Window, 7-14 



FIFO, 7-42 
File 

Append, 6-7 



Download, 7-29 
Load, 7-27 

Load From Command Line, 6- 
Merge Prompt, 7-27 
Overwrite, 6-7 
Reading, 6-7 
Writing, 6-7 
File Format 

Absolute Object Module, F-. 
Intel Hex, F-2 
Motorola S-Record, F-2 
Symbolic Hex, F-l 
Firmware Version, 7-20 
Flicker Toggle, 7-21 
FR Display Sort Order, M-l 
From, 7-33 
Function Key 

Assignment, 7-24 
Clear, 7-24 
Help, 7-25 

Save Assignments, 7-24 
Save Toggle, 7-25 
Write To File, 7-24 
Function Key Label Lines, 6-2 
Number, 7-23 



G 

Global Symbols, 7-55 
Go, 7-33 

From, 7-33 

Until, 7-34 



H 

Help, 6-4 

During Function Key Assignment, 7-25 
HLL 

Archimedes C, G-3, H-l 

BSO/Tasking C, HA 

C, 14, G-2 

Franklin C, G-3, H-l 

Intel PIVM, G-5, H-2 

Line Numbers, 7-54 

MCC C, G-6, H-3 

Modules, 7-53 

No Line Numbers, G-2 

PL/M, G-2 

Raw Source, 7-53 

Search Path, G-l 

Source File Search Path, 7-52 

Source Found, G-l 

Source Image Format, MA 

Source Not Found, G-l 

Tasking PL/M, G-7, HA 
HLL Scopes, 7-54 
Host Computer 

AUTOEXEC.BAT, L-2 

COMMAND.COM, L-l 

CONFIG.SYS, L-l 

Expanded Memory, 7-41 

Requirements, 5-1 
Host Software 

Directory Structure, KA 

Disk Space Requirements, 5-2 

EHSFP Variable, L-2 

File Search, K-l 

Installation, 5-2 



Version, 2-1 
Host Software Files 

SALERT, K-l 
SCLR1S,K-1 
$CLR2$,K-1 
$CLRM$,K-2 
$C0DMEM$,K-2 
SCOLOR, K-2 
SC0NF1G, K-2 
SFKEYDEF, K-3 
SLINE, K-3 
SMISC, K-3 
SMODEL, K-3 
STRDATS, K-3 
SWINDOW, K-3 
Host-break, 7-35 
Hot Key, 6-4 
Hyperlinks, 7-22 



I 

iceMASTER 

Installation, 3-1 

Overview, 2-2 

Owner Registration, 1-3 

Subassemblies, 3-1 
ID Screen, 7-20 
Idle Mode, 8-3 
Ignore Local Symbols 

Command Line Option, J-l 
Internal Data Memory 

Browse Mode, 7-38 

Compare Blocks, 7-39 

Fill, 7-38 

Move Block, 7-39 
Write Dump, 7-39 
Internal Data Window, 7-14 



L 

Label Synchronization, 7-37 
Line, 7-34 

Line Number Bin, 7-43 
Line Numbers, 7-54 

Syntactic Forms, E-2 
Link Options 

Archimedes, H-l 

Franklin, H-l 

Intel, H-2 

Tasking, H-4 
Local Symbols, 7-55 
LOGITECH Mouse, 1-3 



M 

Macro, 6-4 

Command Line Option, J-l 
Create, 7-31 
Delay, 7-31 
Environment, 7-30 
Execute, 7-30 
Learn, 7-31 
Learn Mode, 7-31 
Parameters, 7-30 
Repeat, 7-31 

Stan From Command Line, 6-4 
Macro Delay 



Command Line Option, J-2 
Main Escape Toggle, 7-21 
Main Screen Window 

Activate/Deactivate, 7-17 

Change Mode, 7-18 

Options, 7-18 

O -der, 7-17 

Repaint, 7-19 

Resize, 7-18 

St art Address, 7-17 
Main Screen Windows, 6-2 
Map 

Blocking, 7-4, 7-6 

Load From File, 7-4, 7-7 

Save To File, 7-5, 7-7 
Menu Bar Window, 6-2 
MetaLink 

Address, 1-1 

Fax Number, 1-1 

Plione Numbers, 1-1 

T<;lex Number, 1-1 
Microsoft Mouse, 1-2 
Miscellaneous Options 

Save Toggle, 7-25 
Miss Bin, 743 
Mode Command, 7-2 
Model File, K-3 

A40: Video Display Update, M-2 

A41, M-4 

A42: Performance Analyzer Display Characters, M4 

A43: Three Digit Separator, M-5 

A49:RS232 Time-Out, M-5 

A50: Data Type Display, M-6 

Command Line Option, J-l 
Model File Version, 7-20 
Module Addressing 

Command Line Option, J-2 
Module Bin, 7-43 
Module Update Mode, 7-52 
Modules, 7-53 
Monitor 

Customize Display Attributes And Colors, 7-9 

Use Custom Display Attributes And Colors, 7-9 
Monochrome 

Default Display Attributes And Colors, 7-8 

Screen Size, 7-8 
Mous: 

2- button, 1-1 

3- button, 1-1 
LOGITECH, 1-3 
M crosoft, 1-2 

Mouse Systems White, 1-5 

Movement, 1-1 
Mouse: Systems White Mouse, 1-5 
Multiply-Divide Unit, 742 

N 

Neql Bin, 743 



Opcode Class, 7-61 
Add, 7-61 

Destination Operand, 7-62 
Load From File, 7-62 
Mnemonic, 7-62 
Name, 7-61 



Operands, 7-62 

Remove, 7-61 

Save To File, 7-63 

Source Operand, 7-62 
Opcode Fetch, 7-35 
OS-Escape, 7-32 
OS-Escape Prompt Toggle, 7-22 
Over, 7-34 



PC Indicator, 7-16 
Performance Analysis 

Bin Capture Range, 7-43 

Bin Description, 7-44 

Bin Number, 7-43 

Break Bin, 7-43 

Lnum Bin, 7-43 

Miss Bin, 743 

Mod Bin, 743 

Neql Bin, 743 

Overview, 742 

Proc Bin, 743 

User Bin, 743 
Performance Analysis Emulation, 749 

Expand Display, 7-51 

HLL Display, 7-50 

Miss Bin Toggle, 7-51 

Mixed Display, 7-51 

Raw Display, 7-50 

Sample Counts, 7-51 

Status, 7-50 

Symbolic Display, 7-50 
Performance Analysis Setup 

Accumulate Statistics, 744 

Add Bin, 748 

Capture Span, 747 

Clear, 747 

Clear Statistics, 744 

Delete Bin, 748 

Edit Bin, 748 

Go, 745 

Line Number, 747 
Load From File, 748 
Module, 746 
N-Equal, 746 
Number Of Bins, 746 
Procedure, 746 
Reset (Emulator), 745 
Reset (Target), 745 
Save To File, 748 
Sort Order, 747 

View Statistics (Post Emulation), 745 
Performance Analyzer 

Display Characters, M4 
PL/M 

Source File Naming, G-2 
PL/M Characteristics 

Intel, G-5 

Tasking, G-7 
PL/M Compilation Options 

Intel, H-2 

Tasking, H4 
Ports, 8-3 
Power, 8-1 

Power Connector, 3-8 
Power Down Mode, 8-3 
Power LED, 3-5 
Not Lit, 9-1 



Power Saving Modes, 8-3 
Power Switch, 
Probe Card 
Cable, 3-3 
Protection, 3-3 
Probe Clip 

Break In Signal, 3-7 
Input Signals, 3-7 
Trigger Out Signal, 3-7 
Probe Clip Assembly, 3-7 
Procedure Bin, 7-43 
PROM Version, 7-20 
Public Symbols, 7-55 
Pull-down Menu, 6-2 



Q 

Quick Help Line, 6-2 
Quick Key, 6-4 



R 

RAM-bits 

Display/Alter, 7-40 
Raw Source, 7-53 
Repetition Count 

Set, 7-35 
Repetition Count Indicator, 7-16 
Reset 

Emulator, 7-33 

Processor, 7-33 

Target, 7-33 
Reset Indicator, 7-16 
Reset LED, 3-5 
Reset Push-button, 3-4 
RS-232 

Connector, 3-2 

Interface, 3-2 

Time-Out, M-5 



s 

SBUF, 8-3 

Scopes, 7-54 

Screen Size, 7-8 
Save Toggle, 7-25 

Selecting Commands, 6-4 

Serial Port Register, 8-3 

Simple Break, 7-57 

Single Step, 7-34 

Skip Leading Blanks, G-2 

Slow Motion, 7-34 

Software Version, 7-20 

Source Path, 7-52 

Command Line Option, J-l 
Set From Command Line, 6-4 

Source Window, 7-15 

Stack Hyperlinks Toggle, 7-22 

Stack Window, 7-14 

State Indicator, 7-16 

Static, 8-1 

Status Box, 6-3 

Status Window, 7-15 

Step 

Any Line Number, 7-34 

Current Module Line Number, 7-34 

machine language, 7-34 



Procedure, 7-35 
Symbols 

Address Order, 7-56 
Alphabetized, 7-55 
Global, 7-55 
Local, 7-55 
Syntactic Forms, E-l 

T 

Tab Stops, G-2 

Three Digit Separator, M-5 

Timer Values, 8-2 

To, 7-35 

Trace, 7-65 

Code Display, 7-66 

HLL Display, 7-67 

Mixed Display, 7-67 

Probes Toggle, 7-67 

Raw Display, 7-65 

Search, 7-68 

Write To File, 7-68 
Trace Data Captured Indicator, 7-16 
Trace Data Read Indicator, 7-16 
Trace Prefetch Toggle, 7-21 
Trace Trigger 

Center, 7-64 

End, 7-64 

Start, 7-64 

Variable, 7-64 
Trace Trigger Indicator, 7-16 
Trace-Off-Point, 7-58 
Trace-On-Point, 7-58 
TROFF, 7-58 
TRON, 7-58 
Tutorial 

Jumper Settings, 3-1 

u 

Unknown Data Type Size, 7-22 

Until, 7-34 

Upload, 7-29 

User Bin, 743 

User Module Update, 7-52 

V 

Variable/Registers 

Display/Alter, 7-40 
VGA, 7-8 

Video Display Update, M-2 

w 

Warm Start, 6-5 
Warranty 

Emulator Base, 1-2 

Extended, 1-3 

Probe Card, 1-2 
Watch Window, 7-16 

Add Variable, 7-19 

Remove Variable, 7-19 
Watchdog Timer, 8-4 
Window 

Moving, 6-5 



Resizing, 6-5 
Save Toggle, 7-26 



iceMASTER-68HC11 Supplement 



The complete iceMASTER-68HCll Manual is undergoing final editing and will be available very soon. 
Until then, you can use the information provided here to augment the information in the iceMASTER- 
8051 manual and the online Help system. 



Description of Files 



The following files are supplied on the distribution diskettes for iceMASTER-68HCll: 
ICE.EXE The iceMASTER-68HCll Host Software program. 

$CLR 1 $ File containing default video display color and highlighting values suitable for color CGA/EGA/V GA 

monitors. 

$CLR2$ File containing default video display color and highlighting values suitable for color EGA/VGA 

monitors. 

$CLRM$ File containing default video display "color" and highlighting values suitable for monochrome moni- 

tors. 

MFGEN. EXE Utility program used to generate a $MODEL file to allow use of a particular emulator probe card. The 
emulator host software (ICE.EXE) reads the $MODEL file during its initialization sequence. 

The $MODEL file defines all the specific properties of the chip in the probe card (e.g., the 
68HCUA8). Such items include register definitions, memory sizes, etc. The $MODEL file 
also contains the text for all the online Help Topics. 

During installation of the Probe Card Distribution Diskette, MF GEN will be invoked automatically 
to create the $MODEL file for the probe card you purchased. MF GEN may be reinvoked manually, 
if ever necessary, to regenerate the $MODEL file or to generate a different $MODEL file (for a 
different probe card). 

MODELS. DAT Data file read by the MF GEN utility program. This file contains the information necessary to generate 
a $MODEL file for each available probe card. 

MFG. EXE This program is called only from MF GEN. MFG should never be invoked directly at the DOS 

command line prompt. 



Utility Program Files 

HC11BOOT.AOM This program allows you to emulate the 68HCll's Special Bootstrap operating mode with the 
iceMASTER-68HCll emulator. Detailed instructions for using HC11BOOT.AOM can be found in the 
assembly language source file (HC11BOOT.S07) or the assembler-generated listing file 
(HC11BOOT.LST; see page 9 for further details). All the files associated with the HC11BOOT 
program are: 

HC1 1 BOOT.AOM Loadable, Intel absolute object module format, with symbolic information 
HC1 1 BOOT. BAT Batch file to generate HC11BOOT from scratch 
HC1 1 BOOT.HEX Loadable, standard hex format 
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DEM0_H11.A0M 

DEM0_H11.BAT 

DEM0_H11.HEX 

DEM0_H11.LST 

DEM0_H11.MAP 

DEMO_H11.S07 

DEM0_H11.S19 

HCSTART.LST 

H_CSTART.S07 

HDEMO.AOM 

H_DEMO.H 

HDEMO.MAP 

HHLMAIN.C 

H_HLMAIN.LST 

HJNNER.C 

HJNNER.LST 

H_MAKE.BAT 

HMAKE.LCL 

HMAKE.XCL 

H_WASTE.C 

H WASTE. LST 



HC1 1 BOOT. LST Assembler output listing 

HC11 BOOT. MAP Linker memory map 

HC1 1 BOOT. S07 Assembly language source 

HC1 1 BOOT.S1 9 Loadable, Motorola S-Record format 

Simple Assembly Language Demonstration Program 

Loadable, Intel absolute object module format, with symbolic information 

Batch file to generate DEMO_Hll from scratch 

Loadable, standard hex format 

Assembler output listing 

Linker memory map 

Assembly language source 



Loadable, Motorola S-Record format 



Simple IAR/Archimedes C Language Demonstration Program 

Assembler-generated listing file for HCSTART.S07 
Assembly Language source module (C runtime library startup module) 
Loadable, absolute object module format, (with debug information) 
C language ^include file 
Linker-generated map of H DEMO.AOM 
Main program (function 'main()'; C source) 
Compiler-generated listing file for H HLMAIN.C 
Function 'innerloopO' (C source) 
Compiler-generated listing file for H JNNER.C 
Batch file to generate H DEMO.AOM from scratch 
Librarian control file for generating HDEMO.AOM 
Linker control file for generating H DEMO.AOM 
Function 'wastetime()' (C source) 
Compiler-generated listing file for H WASTE.C 
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Register Bit Names 



To further enhance the iceMASTER-68HCll emulator, we have supplied special symbols in the 
$MODEL file for the bit names in those registers which have special functions assigned to different 
bits in the register. These symbols are the standard names preceded by an at-sign (@). These symbols 
are special because encoded in their internal addresses are both the byte offset of the register into the 
Register Block and the mask to denote the bit within the register. When browsing or perusing the 
Register Window (Configure | Windows | Goto command), a box will pop-up over, for example, SCCR2, 
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Figure 1 



showing all the bits defined in that register (e.g., @RE). To toggle a bit's value, all you have to do is 
type the name of the bit. We preceded these names with the at-sign (@) so that these predefined 
symbols would not conflict with any symbolic information in your program. 

iceMASTER-68HCll always displays the individual bits of the CCR (Condition Code Register) in the 
top line of the Register Window. The individual bits in the CCR can be referenced symbolically using 
their standard names (e.g., N). 
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I NIT Register Configuration 



The 68HCll's INIT Register specifies the starting addresses of the on-chip RAM and Register Blocks. 
By default, the RAM block begins at and the Register Block begins at 4K ($1000). If your application 
program requires different starting addresses for either the RAM or the Register Blocks, you can use 
the Configure \ Emulator \ INIT Register command to pop up a menu allowing you to set up the emulator 
to use a different starting location for either one, or both, of these on-chip blocks. In addition, your 



ionf igure 



Emulator 



File Run 

"5ir 



Display/Alter Hisc Source/Symbols Break/Trace Help 
Reg i steps 68HC 1 1A0— , 



V:8BBB SP:8888 CCR:D8 
ADR3- 
DDRD ■ 
Stack 



Execute 


ADR2 ■ - 08 
COPRST 88 


Conn port 
Baud rate 


corn 

115288 




F FF FF FF 




INIT register 


01 




LDX 



SI X:l H:8 1:1 H:8 Z:0 U:0 C:8 
•88 ADR4--88 BAUD- • -87 
88 HFRIO - -25 INIT - - -81 
SP : 8888— 



-Source- 



PROH 



*$18B8 

68HC11 INIT Register Configuration 



Fi le :demo_hll .am — 
X=8888 n8z8uB 



r"unction-X|| 
>ave 



Iff 



TTTTC Starts at $0888 ($81B8/2S6 bytes): 



INIT Register = $81 



FF94 8D19 
FF96 8601 
FF98 A808 



Register Block Starts at $1800 C $0840/64 bytes): 

8K E3 8K 12X 16K 28K 24K 28X 32K 36X 48K 44K 48K 52X 56K 60X 

Enter : Accept E sc : Cance 1= 

$08, X 

-Status 



BrkCnt :B Tine - . 3ps State : Break-point 

RepCnt - 1 Resets: 8 Trace : Partial Read : 188x Trig: End 



SP : 0880 PC : FF83 
BrkAddr:FF83 



«-»:Set start address for RAN Block 




ti:Hodify Register Block start address 
■LinS 



application program is responsible for setting the INIT register to the same value (if you start emulation 
using any of the emulation reset commands: Run | Reset | Normal | Emulator, Run \ Reset \ Normal | Tar- 
get, Run | Reset \ Special \ Emulator or Run \ Reset \ Special \ Target) . 

Each time emulation breaks, the host software and emulator firmware perform several validity checks 
to ensure that the INIT register does indeed contain the value specified here. 

To actually effect the change to the INIT register, you must select the Configure {Emulator [Execute 
command. As part of the sequence of steps initiated by the Configure [Emulator] Execute command, 
the following code fragment is executed, starting from a Normal Mode reset, in the 68HC11 processor 
in the probe card: 



86xx ldaa #init_value 

B7103D STAA $103D 



value specified in menu 
default location of INIT 



This is done primarily so that any Windows into the on-chip RAM (e.g., the Stack Window) or the 
Register Block (e.g., the Register Window) are painted initially with the current, correct values before 
you actually load a program and begin emulation. 



A 
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The Configure \Emulator\INIT Register pop-up menu also shows the location and size of any other 
on-chip memory resource which may be, or have become, enabled (visible). This information is 
displayed at the bottom of the menu, as shown in Figure 3. Note that the menu in Figure 3 is shown for 
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BrkCnt:8 
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-6BHC11 INIT Register Configuration- 



ilEBTC Starts at $8888 ($8280/512 bytes): 



INIT Register = $81 



4K 8K 12K 16K 28K 24K 28X 32K 36K 48K 44K 48K 52X 56K 68K 



Register Block Starts at $1000 ($8840/64 bytes): 

8K EES 8K 12K l&K 20K 24K 28K 32K 36K 48K 44K 48K 52X 56K 68X 



CONFIG: EEPROH Block Starts at $B600 ($0280/512 bytes) 

HPRIO: Bootstrap RON Block Starts at $BF4B ($00C0/192 bytes) 

CONFIG: Code RON Block Starts at $D000 ($3880/12288 bytes 
—Enter : Accept E sc : Cance 



3 

i 



«■-» : Set start address for RAM B l ock 1 4.: Hod i f 9 Regis t er Bloc k start a ddress 

Figure 3 



ynftlph 
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illustrative purposes only. You should not operate the iceMASTER-68HCll with either the on-chip 
Bootstrap ROM enabled or the on-chip ROM enabled. 



iceMASTER-68HCH Emulation Environment Requirements 



HPRIO.MDA = 1 

Normal Expanded or Special Test mode in effect. The 68HC11 processor in the probe card must 
physically be operated in either the Normal Expanded mode or the Special Test mode. The 
iceMASTER-68HCU emulator supports the Normal modes (Expanded or Single-Chip) via two 
different probe cards: a probe card for Expanded mode and a probe card for Single-Chip mode . 
Either of these probe card types (Expanded or Single-Chip) can also be operated in the Special 
Test mode . The Special Bootstrap mode is supported via the supplied utility program 
HC11BOOT.AOM; commentary at the beginning of HC11BOOT.S07 (source) and 
HC11BOOT.LST (listing) describes how to use the iceMASTER-68HCll emulator to execute in 
the Special Bootstrap mode environment (see page 9 for further details). 

CONFIG.ROMON = 

On-chip program ROM disabled. You cannot execute in the on-chip ROM. If you should 
inadvertently set the ROMON bit in the CONFIG register, the host software will detect this 
situation when you select the Configure \ Emulator \ Execute command and attempt to recover. 
The recovery action consists of rewriting the CONFIG cell/register, with the ROMON bit turned 
off, and then resetting the 68HC11 part. This is the only time that the emulator automatically 
writes to the CONFIG cell. If you desire to make any other changes to the CONFIG cell/register, 
you can make them directly using either the Display/Alter \ Var/Reg command, or the Config- 
ure | Windows \ Goto command and position into the Register Window — see page 8. 
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HPRIO.RBOOT = 



On-chip Bootstrap ROM disabled. You cannot execute in the on-chip Bootstrap ROM. How- 
ever, see the utility program HC11BOOT (page 9), which copies the Bootstrap ROM code from 
the on-chip Bootstrap ROM into emulation code memory, whence the Bootstrap code can then 
be executed in Special Test mode. 

HPRIO.IRV = 

Internal Read Visibility disabled. We recommend that you run with IRV disabled. 

Miscellaneous 

Mapping The host software will force any enabled (visible) on-chip memory resource (e.g., on-chip RAM, 

Register Block, on-chip EEPROM) to be mapped to the emulator. Such areas cannot be mapped to 
memory in your target system. After each emulation cycle, the emulator firmware and host software 
check to see if the status of any on-chip memory resource has changed (enabled vs. disabled). If so, the 
emulator will adjust the mapping automatically to account for the change. 

Note: Even though the on-chip memory area is reported as being mapped to the emulator base, the 
memory area actually referenced during emulation is the on-chip memory resource itself. 

Break-Points If a CBREAK: Code Break-Point is set on an instruction, emulation breaks (stops) before that 
instruction executes. The same holds true for Trace-On-Points and Trace-Off-Points points. 

A WBREAK: Write Access Break-Point at a particular location causes emulation to break (stop) after 
execution of an instruction writing to (storing into) that location. In such a case, the memory location 
is updated (i.e., the write is not suppressed). In addition, if the program's execution flow happens to 
pass through that location, emulation breaks before fetching the opcode from that location. Write 
Access Break-Points are available only in the Simple Break window. 

A PBREAK; Write Protect Break-Point on a particular memory location causes emulation to break 
after execution of an instruction which attempts to write to (store into) that memory location. In such 
a case, the memory location is nol updated (i.e., the write is suppressed). Write Protect Break-Points 
can only be set for a memory location/range mapped to the emulator base, not for a memory 
location/range mapped to the target system. Additionally, Write Protect Break-Points are available 
only in the Simple Break window. 

You can execute code in either the on-chip RAM or the on-chip EEPROM. However, you cannot set 
Code or Write Protect break-points (using the Break/Trace \Set menu) in any of the enabled on-chip 
memory areas. These include the on-chip RAM, on-chip Register Block and on-chip EEPROM. If the 
processor is executing in an on-chip memory area (RAM or EEPROM) when a break in emulation 
occurs (e.g., by pressing the Break button on the emulator base or by pressing the Esc key), the software 
will warn you that such a condition has occurred and that the 68HC11 processor in the probe card has 
been resei. In such cases, you can use the Trace Buffer to find out where the program was executing 
when emulation stopped. 

The following table summarizes which type of break-/trace-points can be used in the various memory 
areas: 
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Break-Alrace-Point i 


Vvauabiuty 




Break-/Trace-Point "type 


Or 


i-Chip Men 


tones 


64K 
Emulation 
iviemory 


64K 
Target 
ivieinory 




RAM 


Registers 


EEPROM 


CBREAK 
Code Break-Point 


No 


No 


No 


Yes 


Yes 


PBREAK 

Write Protect Break-Point 


No 


No 


No 


Yes 


No 


WBREAK 

Write Access Break-Point 


Yes 


Yes 


Yes 


Yes 


Yes 


TRON 

Trace-On-Point 


Yes 


Yes 


Yes 


Yes 


Yes 


TROFF 
Trace-Off-Point 


Yes 


Yes 


Yes 


Yes 


Yes 



Stack 



File 

Loading 



On-Chip 
Memories 

Writing 
EEPROM 



If the Stack Pointer (SP Register) is pointing into the on-chip RAM before emulation begins, the next 
unused byte at the top of the stack will be changed (written) upon restarting emulation. This is a side 
effect of needing to restore the A Register without affecting any of the bits in the Condition Code 
Register (CCR). 

If the SP register is pointing into any other memory area (e.g., off-chip RAM), no memory contents will 
be changed when emulation is restarted. 

You use the File \ Load command to load a file into the emulator, initializing memory with the image of 
your program. This can be either the emulator's memory or memory in your target system, or both, 
depending on the current mapping (Configure \ (Mapping)Code Memory command). 

If the file contains bytes which are destined for the on-chip RAM, the on-chip RAM will be initialized 
with those bytes. 

In addition, if the on-chip EEPROM is enabled, any bytes in the file destined for the on-chip EEPROM 
will be written there using the standard "erase-before-write" method, one byte at a time. However, due 
to optimizations employed during file loading, we recommend that, if your program file contains 
initialization for EEPROM, you first use the Display /Alter | Code \Fill command to fill all of EEPROM 
with $FF bytes before actually loading the file. 

When a value is written to an on-chip memory (e.g., on-chip RAM or Register Block), the correspond- 
ing location in the 64K memory in the emulator base unit is also written with the same value. 

Whenever the iceMASTER-68HCll writes to on-chip EEPROM memory, it pops up a box showing 
which locations in EEPROM are being written. This is done because writes to an EEPROM location 
take considerably longer than writes to other memories, due to the "erase-before-write" technique 
used and the need to delay 10 milliseconds after each erase and write operation. 

The only time iceMASTER-68HCll writes to EEPROM memory is when the on-chip EEPROM is 
enabled and you explicitly request the write to take place (e.g., by using the Display /Alter \Code \Fill 
command or by loading a file which initializes all or part of the EEPROM). 
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Writing the You can change the value in the CONFIG cell/register, subject to the normal operating restrictions of 

CONFIG the 68HC11 processor in the probe card. That is, you must first put the processor into Special Test 

Cell/Register Mode in order to be able to write to the CONFIG cell (an EEPROM location in most parts). In 
addition, if the processor has a BPROT register, you must at least set the PTCON bit in the BPROT 
register to zero before attempting to update the CONFIG cell. Finally, you will not see any immediate 
confirmation that the new value was actually written to the CONFIG cell; you must cause the processor 
to go through a reset in order to have the value in the CONFIG cell copied into the CONFIG register. 



Disassemblies In disassemblies, several opcode mnemonics have aliases (alternative mnemonic names). In such cases, 
the alternative name will be shown as a comment next to the disassembled instruction: 



Mnemonic 


Alias 


ASLD 


LSLD 


BCC 


BHS 


BCS 


BLO 


ASLA 


LSLA 


ASLB 


LSLB 


ASL 


LSL 



You can use either form shown above when patching in new instructions using the single-line assembler 
{Display IAlter\AsmlDasm \Assemble command). 

Additionally, the Display/Alter \AsmlDasm {Disassemble command disassembles words (byte pairs) in 
the current Interrupt Vector area as 

ivect <address> 



The current Interrupt Vector area is determined by the current operating mode of the 68HC11 
processor in the probe card. The Special Modes Interrupt Vectors are located at $BFC0 through 
$BFFF. The Normal Modes Interrupt Vectors are located at $FFC0 through $FFFF. 

Status The top right hand border of the Status Window will show "Mode:Special" whenever the 68HC11 

Window processor in the probe card is in Special Test mode (HPRIO.MDA = 1) at a break-point. 

View Trace In the Break/Trace \ View Trace menu, when the display mode is either Code or Mixed, a small box may 

pop up at the currently highlighted instruction in the Trace Buffer. This box contains information 
extracted from the trace frames for the execution of that instruction. This information consists of values 
of locations/registers manipulated by that instruction. The top border of the box may show "(updated 
value)" to indicate that the value shown in the box is the value after the instruction executed: 



View Trace Pop-Up Box Content 


Applicable 
Instructions 


■ 

mem[xxxx]=xx 


{many} 


mem [ xxxx ] =xxxx 


{many} 


mem[xxxx]=xx; result=xx 


{many} 


SP=XXXX 


TSX,TSY 


CCR=xx , B=xx , A=xx , X=xxxx , Y=xxxx , Re t=xxxx 


RTI.SWI 
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TEST If the TEST instruction (opcode value $00) is executed during emulation in Special Test Mode, a box 

Instruction will pop up informing you that the processor in the probe card is inactive. If you press Esc, the host 

software will ask you whether or not you want to reset the 68HC11 processor to break (stop) emulation. 

ACTIVE When the green ACTIVE light on the emulator base is on, it indicates that the LIR and AS signals in 

Light the 68HC11 are toggling properly. 

XIRQ When emulation stops, XIRQ is disabled. When emulation begins/resumes, XIRQ is enabled. 

Reading The origin of Port values displayed in the Register Window depends on the configuration of each port 

Ports pin. If the pin is configured as an output pin, the value displayed is that from the port register. If the 

pin is configured as an input pin, the value displayed is that from the port pin. 



Special Bootstrap Mode 



The HC11BOOT.AOM utility program allows you to use the iceMASTER-68HCll emulator to execute 
in the Special Bootstrap mode environment. The listing for HC11BOOT appears on the following 
pages. The commentary box at the beginning of the listing provides detailed instructions for using 
HC11BOOT. 
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# # 

# Archimedes 6801 Assembler V1.85/M02 09/Aug/91 04:07:55 # 

# # 
U Source = hc11boot.s07 # 

# List = hcllboot.lst # 

# Object = hc11boot.r07 # 

# Options = s x # 

# # 

# (c) Copyright Archimedes Software Inc. 1987 # 



1 * Source File: HC11BOOT.S07 

2 

3 0000 NAME HC11BCOT 

4 0000 TITL 'HC11BOOT -- Prepare for Bootstrap Loading' 

5 0000 P68H11 Enable the HC11 instruction set 

6 ^ 

8 * The HC11BOOT program allows you to emulate the 68HC11's 

9 * Special Bootstrap operating mode with the iceMASTER-68HC1 1 : 

10 * 

11 * 1. Select the 'Run|Reset |Special |Processor' command. 

12 * This resets the 68HC11 processor in the probe card into 

13 * Special Test mode. The only reason for doing this is so 

14 * that, after loading the HC11BOOT program in step 2 below, 

15 * the host software can "tell" you where execution will begin. 

16 * Because the processor is in a Special mode rather than a 

17 * Normal mode, execution from a reset will begin at the address 

18 * contained in the Special Modes Reset Vector ($BFFE), rather than 

19 * at the address contained in the Normal Modes Reset Vector (SFFFE). 

20 * This is only an issue with respect to painting the Source and 

21 * Status Windows to reflect the (assumed) current PC value after 

22 * a new program has been loaded into the emulator. 

23 * 2. Select the 'File|Load' command: 

24 * a. File to load: HC11BOOT.AOM (this program) 

25 * b. Merge into current 

26 * application environment?: No 

27 * 3. Select the 'Break/Trace|Set |Add|CBREAK: Code Break-Point' command: 

28 * a. Set a single, simple break-point at: 8RKADDR 

29 * 4. Select the ' Run | Reset | Special |Emulator' command. 

30 * This begins execution of this program (HC11BOOT) from a reset 

31 * condition, running in Special Test mode. This program copies 

32 * the bootstrap loader from the on-chip Bootstrap ROM into the 

33 * corresponding memory locations in the emulator's code memory. 

34 * After copying the bootstrap loader, this program reaches the 

35 * break-point at 'brkaddr'. 

36 * 5. Select the 'Break/TracelClear' command to remove all break-points 

37 * (specifically, the simple break-point at BRKADDR) . 

38 * 6. Select the ' Run I Reset I Special [Emulator' 

39 * or the 'Run|Reset | Special |Target' command 

40 * depending on your target environment configuration. 

41 * This begins execution of the 68HC11 bootstrap loader from a 

42 * reset condition, running in Special Test mode. 
43 

44 * NOTE that HC11BOOT modifies the Special Modes Reset Vector during 

45 * execution. This happens because it copies the Reset Vector from the 

46 * Bootstrap ROM into the Special Modes Reset Vector in emulation code 

47 * memory. Thus, if you need to run HC11B00T several times in succession, 

48 * you must 'File|Load' the HC11B00T program each time (i.e., repeat steps 

49 * 1 through 6 above each time). 

50 ***»*********************************»**»**...*****«***.»*****#«***»****»***** 

51 

52 * Register Equates 

54 1000 REGBAS EQU $1000 starting address for Register Block 

55 003C HPRIO EQU $3C Highest Priority Interrupt and Miscellaneous Register: 

56 0080 RBOOT EQU $80 HPRIO. 7 On-chip Bootstrap ROM enabled 

57 » Misc 

58 00B0 STKBAS EQU $0080 beginning of stack in on-chip RAM 

59 BF40 brom_ba EQU $BF40 Bootstrap ROM beginning address (ch ip- dependent ) : 

60 * A0,A1,A2,A8,E0,E1,E2,E9: $BF40 

61 * D3,F1: $BF00 

62 BFFF brom ea EQU $8FFF Bootstrap ROM ending address (never changes) 

63 00C0 bronTsz EQU (brom_ea-brom_ba)+1 # of bytes in Bootstrap ROM 

64 C000 buf_ba EQU brom ea+1 beginning addr of temp buffer for boot code 

65 O0C0 buf_sz EQU bronTsz # of bytes in temp buffer for boot code 

66 * (same size as Bootstrap ROM) 

67 C0BF buf_ea EQU buf_ba+(buf_sz-1 ) ending addr of temp buffer for boot code 
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68 COCO 

69 

70 

71 

72 

73 

74 

75 

76 

77 

78 

79 

80 

81 

82 

83 

84 

85 

86 

87 

88 

89 

90 

91 

92 

93 

94 

95 

96 

97 

98 

99 
100 
101 
102 

103 COCO 

104 COCO 

105 COCO 
106 

107 
108 
109 

110 C0C3 

1 1 1 C0C6 

112 C0C9 

113 COCC 
114 

115 C0O0 

116 C0D2 

117 C0D5 

118 C0D6 

119 C0D8 

120 CODB 
121 

122 
123 
124 
125 
126 

127 CODD 

128 COEO 

1 29 C0E3 

130 C0E6 
131 

132 COEA 

133 COEC 

134 COEF 

135 COFO 

136 C0F2 

137 C0F6 
138 

139 
140 
141 
142 
143 
144 
145 
146 

147 C0F8 



porg 



EQU 



buf ea+1 



program origin 



* Memory Layout for HC 11 BOOT: 



8E00B0 



CE1000 
1C3C80 
CEBF40 
18CEC000 

A600 

18A700 

08 

1808 

8CC000 

25 F3 



CE1000 
1D3C80 
CEC000 
18CEBF40 

A600 
18A700 
08 
1808 

188CC000 
25 F2 



$0000 

$(RAMend) 

$(RAMend+TT 

SOFFF 

$1000 

$(Regend) 

$(Regend+TT 

$2000 

$3000 

$4000 

$5000 

$6000 

$7000 

$8000 

$9000 

$A000 

$BF3F/BEFF_ 
$BF40/BF00 



$BFFF_ 
$C000 



$C0BF/C0FF 

$C0C0/C100~ 

$C0F9/C139 

$C0FA/C13A" 

$D000 

$E000 

$F000 

$FFFF 



■RAM Block 



<default location -- 
this program uses none> 
(not used by this program) 

•Register Block {default location -- 

this program uses only HPRIO} 
•(not used by this program) 



Step 1 : 
Bootstrap 
ROM On 



Step 2: 
Bootstrap 
ROM Off 



•Boot loader Code Bytes 
(in Bootstrap ROM 
and emulator's RAM) 

•Buffer into which Bootstrap 
ROM bytes are first copied 
from on-chip Bootstrap ROM 

■This program (HC11BOOT) 



from 



to 



to 



from 



-(not used by this program) 



start: 



ORG 
LDS 



porg 
#STKBAS 



establish top of stack 



1. Copy on-chip Bootstrap ROM bytes, including Special Modes 
Interrupt Vectors, to temporary buffer in emulator's code 



iry: 



LDX 
BSET 
LDX 
LDY 

cpyllp: LDAA 
STAA 
I NX 
I NY 
CPX 
BLO 



#REGBAS 
HPRIO, X,#RBOOT 
#brom ba 
#buf_Ea 

o.x 

0,Y 



#brom_ea+1 
cpyllp 



enable on-chip Bootstrap ROM (make it visible) 
starting address: from 
starting address: to 

loop 
to 

copy 

one 

byte 

at a time 



Copy Bootstrap ROM bytes and Interrupt Vectors from temporary buffer 
in emulator's code memory to the "normal" locations for the boostrap 
loader code (but copy into the emulator's code memory, not into the 
on-chip Bootstrap ROM): 



LDX 
BCLR 
LDX 
LDY 

cpy2lp: LDAA 
STAA 
I NX 
I NY 
CPY 
BLO 



#REGBAS 

HPRIO,X,#RBOOT disable on-chip Bootstrap ROM (make invisible) 



#buf_ba 
#brom_ba 

0,X 
0,Y 



#brom ea+1 
cpy2lp 



starting address: 
starting address: 

loop 
to 

copy 

one 

byte 

at a time 



from 
to 



* Uith a break-point set at 'brkaddr', when emulation breaks, 

* you should select the 'Run I Reset I Special [Emulator' or 

* 'Run | Reset |Special | Target' command to begin 

* execution of the bootstrap loader. Ue do this, rather than jumping 

* directly to 'brom_ba' here, in case there is any assumption/requirement 

* within the bootloader code that it begin execution from "pure" reset 

* conditions. 

brkaddr: 
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Aug 9 04:13 1991 . ./hd 1boot . 1st Page 3 



148 C0F8 20 FE 

149 

150 

151 BFFE 

152 BFFE COCO 

153 BFFA 

154 BFFA COCO 

155 BFFC 

156 BFFC COCO 
157 

158 BFFE 



BRA * 

* Establish the actual Reset Vector: 

ORG SBFFE Special Modes Reset Vector address 

FDB start 

ORG SBFFA Special Modes COP Failure 

FDB start 

ORG SBFFC Special Modes Clock Monitor Fail 

FDB start 

END 



Errors: 

Bytes: 

CRC: 



None 
64 

8B92 



# HC11BOOT # 



Symbol and Cross Reference Table 



Symbol Value Type Defline Refline 

Segment Definitions 



External Symbols 



Public Symbols 



Local Symbols 

















HPRIO 


003C 


A 


55 


111 


128 




RBOOT 


0080 


A 


56 


111 


128 




REGBAS 


1000 


A 


54 


110 


127 




STKBAS 


OOBO 


A 


58 


105 






brkaddr 


C0F8 


A 


147 








brom_ba 


BF40 


A 


59 


63 


112 


130 


brom_ea 


BFFF 


A 


62 


63 


64 


119 


brom_sz 


0OCO 


A 


63 


65 






buf_ba 


cooo 


A 


64 


67 


113 


129 


buf_ea 


C0BF 


A 


67 


68 






buf_sz 


00C0 


A 


65 


67 






cpyllp 


CODO 


A 


115 


120 






cpy2lp 


COEA 


A 


132 


137 






porg 


COCO 


A 


68 


103 






start 


COCO 


A 


104 


152 


154 


156 



Macro Definitions 
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iceMASTER-68HC11 Probe Cards 



Processor Used The processor actually used in each probe card is as follows: 



Probe Card Type 


Processors Supported 


Processor Used 
in Probe Card 


68HC11 Expanded Mode 


6 8HC11A0 
68HC11A1 


6 8HC11A1 


g 8HC1 IDO 


6 8HC1 IDO 


68HC11E0 
68HC11E1 


68HC11E1 


68HC811E2 


68HC811E2 


68HC11F1 


68HC11F1 


68HC11 Single-Chip Mode 


6 8HC11A7 
6 8HC11A8 


68HC11A1 


68HC11D3 
68HC711D3 


68HC11D0 


68HC11E8 
68HC11E9 
68HC711E9 


68HC11E1 


6 8HC811E2 


68HC811E2 



All probe cards are shipped from the factory with the on-chip EEPROM memory disabled (CON- 
FIG.EEON = 0) and with the COP (Computer Operating Properly) WDT (Watchdog Timer) 
disabled (CONFIG.NOCOP = 1). Additionally, for those parts having a moveable EEPROM (e.g., 
68HC811E2 and 68HC11F1), the CONFIG register is set up so that if the EEPROM is enabled, the 
EEPROM initially will not be at the high end of memory (i.e., not covering the Normal Modes 
interrupt/reset vectors). 

Jumper Blocks All iceMASTER-68HCll probe cards, whether Expanded mode or Single-Chip mode, have only one 
user-selectable jumper block: 

XTAL - Clock Source 

The function of the XTAL Jumper is to select the source of the clock (oscillator) for the 68HC11: 

PC: Probe card's crystal is used. 

TAR: Target system supplies crystal or external clock. 
This is a double jumper to ensure correct configuration. The center post is the common post. 
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68HC11E* 
Probe Cards 



68HC11DX 
Probe Cards 



Single-Chip 
Mode 

Probe Cards 



We use the 68HC11E1 chip in the probe cards which support the following devices: 

68HC11E0 
68HC11E1 
68HC11E8 
68HC11E9 
68HC711E9 

The 68HC11E1 physically has an EEPROM/CONFIG Block Protect Register - BPROT. BPROT is 
initialized out of Reset (every time) to prevent writing to the EEPROM memory and to the CONFIG 
cell. The 68HC11E0 and 68HC11E8 chips do not have a BPROT Register (i.e., they do not have this 
secondary level of protection against writing to some EEPROM cell). 

If you are developing a 68HC11E0 or 68HC11E8 application using the iceMASTER-68HCll emulator, 
you must account for the fact that the BPROT Register physically exists in the chip in the probe card. 
The simplest solution is to add code which clears (zeroes-out) the BPROT Register immediately after 
a Reset. If you wish, you can even leave this BPROT-clearing code in when you go into production with 
your application. Writing to a non-existent register in the Register Block is harmless in most cases. 

When using a probe card supporting the 68HC11D0, 68HC11D3 or 68HC711D3, you must explicitly 
clear the ROMON bit in the CONFIG register after every reset. The default state of the ROMON bit 
in the CONFIG register following a reset is 1 (ROM enabled). 

All iceMASTER-68HCll Single-Chip mode probe cards use either the MC68HC24 or MC68HC27 
Port Replacement Unit to recreate the single-chip mode functions of Ports B and C. The resultant 
timing characteristics of the probe card reflect the internal timing in the MC68HC24/MC68HC27 
device with respect to STRA, STRB, PORTB and PORTC. Refer to the appropriate data book 
(MC68HC24 or MC68HC27) for complete details. 

The iceMASTER-68HCll host software forces the registers at $x002-$x007 to appear to be mapped to 
your target system. This is done only to support the operational characteristics of the MC68HC24 or 
MC68HC27 Port Replacement Unit in the probe card. 

Finally, for all Single-Chip mode probe cards, it is safest to initialize the INIT register explicitly after 
every reset. The reason is that even though the INIT register in the 68HC11 part is time-protected in 
Normal Expanded mode, the mirror INIT register maintained in the MC68HC24/MC68HC27 PRU 
part is a write-once register. That is, this mirror INIT register can be written at any time after each 
reset, but it can only be written once after each reset. Normally, this would present no problem. 
However, if the first attempt to write to the INTT register occurs later than the first 64 cycles following 
a reset, the new value will be written to the mirror INIT in the PRU but not to the INIT in the 68HC11. 
Conversely, you should write to the INIT register only once following a reset. Again, the mirror INIT 
in the PRU can be written only once following a reset; all other writes to this mirror INIT, even if they 
occur within 64 cycles of the reset, will be ignored (unlike the 68HC11 part itself). 
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iceMASTER-COP8 Supplement 



The complete iceMASTER-COP8 Manual is undergoing final editing and will be available soon. Until 
then, you can use the information provided here to augment the information in the iceMASTER-805 1 
manual and the online Help system. 



Description of Files 



ICE.EXE 
$CLR1$ 

$CLR2$ 

$CLRM$ 

MF GEN. EXE 



MODELS.DAT 



MFG. EXE 



$CR_C880 
$CR C888 



MKSHF.EXE 

MKSHF.DOC 
MKSHF.EXC 



The following files are supplied on the distribution diskettes for iceMASTER-COP8: 
The iceMASTER-COP8 Host Software program. 

File containing default video display color and highlighting values suitable for color CGA/EGA/VGA 
monitors. 

File containing default video display color and highlighting values suitable for color EGA/VGA 
monitors. 

File containing default video display "color" and highlighting values suitable for monochrome moni- 
tors. 

Utility program used to generate a $MODEL file to allow use of a particular emulator probe card. The 
emulator host software (ICE.EXE) reads the SMODEL file during its initialization sequence. 

The $MODEL file defines all the specific properties of the chip in the probe card (e.g., the 
COP880). Such items include register definitions, memory sizes, etc. The SMODEL file 
also contains the text for all the online Help Topics. 

During installation of the Probe Card Distribution Diskette, MF GEN will be invoked automatically 
to create the SMODEL file for the probe card you purchased. MF_GEN may be reinvoked manually, 
if ever necessary, to regenerate the SMODEL file or to generate a different SMODEL file (for a 
different probe card). 

Data file read by the MF_GEN utility program. This file contains the information necessary to generate 
a SMODEL file for each available probe card. 

This program is called only from MF_GEN. MFG should never be invoked directly at the DOS 
command line prompt. 

Emulator Control RAM initialization files. The host software automatically downloads one of these 
files (depending on which probe card you are using) into the emulator base unit during initialization. 

MKSHF Utility Program Files 

Utility program to MaKe a Symbolic ".HEX" File, using as inputs the symbol (.SYM) file produced by 
the National's COP800 Assembler and the loadable (.HEX) file produced by National's LMHEX 
utility. The MKSHF utility is described in more detail on page 4. 

Describes how to use the MKSHF.EXE utility program. 

Standard "exception" file which can be used in creating a customized exception file for input to the 
MKSHF utility. 
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DEM0_C8.ASM 

DEM0_C8.BAT 

DEM0_C8.EXC 

DEM0_C8.HEX 

DEM0_C8.LM 

DEM0_C8.LST 

DEM0_C8.SHF 

DEMO C8.SYM 



Simple Demonstration Program 

COP8 demo program (COP800 assembly language source) 
Batch file to create loadable DEMO_C8.SHF from scratch 
Exception File (input to MKSHF.EXE) for DEMO_C8 
LMHEX-generated ".HEX" file for DEMO_C8 
Assembler-generated load module file for DEMO_C8 
Assembler-generated listing file for DEMO_C8 
Symbolic HEX File for DEMO_C8 (loadable into iceMASTER) 
Assembler-generated symbol file for DEMO_C8 



Special Bit Names for Some Registers 



To further enhance the iceMASTER-COPS emulator, we have supplied special symbols in the 
$MODEL file for the bit names in those registers which have special functions assigned to different 
bits in the register. These symbols are the standard names preceded by an at-sign (@). These symbols 
are special because encoded in their internal addresses are both the byte address of the register and 
the mask to denote the bit within the register. When browsing or perusing the Register Window 
("Configure | Windows | Goto" command), a box will pop-up over, for example, CNTRL, showing all 



-C0P888CG (DEMO)- 



A:8B B:88 X:BB SPI6F HC:8 C:8 T1PNDA:8 T1ENA:B EXPND:8 BUSV:8 EXEN:8 GIE:8 



THR3L0 


ee 


TMR3H I 


88 


T3RAL0 


88 


T3RAHI 


88 


I3RBL0 


CHPSL 


88 


TBUF 


88 


RBUF • 


88 


ENU 


81 


ENUR 


PSR 


88 


TMRZLO 


88 


THR2HI 


88 


T2RAL0 


88 


T2RAH I 


T2CMTRL 


88 


UDSUR 


D9 


UKEDG 


88 UKEN 


88 


UKPND 


PORILP 


FF 


PORTGD 


88 


PORIGC 


88 


PORTGP 


FF 


PORT I • 




BF 


PORID • 


-FF 


T1RBLO 


88 


T1RBHI- 


88 


I CNTRL 


=: 


88 


T1RAL0 


88 


T1RAHI 


88 




es 


PSU- • • ■ 



F2 88 F3 88 F4 88 



88 FA 



88 FB - 



88 



PassCt:B 
RepCnt : 1 



Tine: 
Resets : 8 



88EE 

88 CNTRL. 7 8T1C3 8 
48 CNTRL . 6 BT1C2 8 
28 CNTRL. 5 BT1C1 8 
IB CNTRL. 4 BT1CB B 
88 CNTRL. 3 0HSEL B 
B4 CNTRL. 2 8IEDG B 
82 CNTRL. 1 BSL1 8 
81 CNTRL. 8 BSL8 8 



88 T3RBHI 
88 ENUI ■ ■ 
88 T2RBL0 - 
88 PORTLD 
88 PORTCD 
88 SIOR 

•88 FB 

88 F7 

6F B 



88 T3CNTRL -88 
88 BAUD ■ ■ - 88 
88 T2RBHI 88 
88 PORTLC 
88 PORTCC 
88 TNR1L0 - 88 

88 Fl 8C 

88 F8 BC 

08 S &$ 

SP:6F- 



88 



SP:6F PC: 8888 
Read: By. Trig: End BrkAddr : 8888 



Tab/Shift-Tab :Next/Preu uindou (Keypad) :Scrnl 1 (Nunber)Enter .Change 



the bits defined in that register (e.g., @IEDG). To toggle a bit's value, all you have to do is type the 
name of the bit. We preceded these names with the at-sign (@) so that these predefined symbols would 
not conflict with any symbolic information in your program. 

iceMASTER always displays the individual bits of the PSW register in the top line of the Register 
Window. Because there is special processing internally to do this, the individual bits in the PSW register 
can be referenced symbolically using either their standard names (e.g., HC) or using the @-names (e.g., 
@C). 
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Rn (Fn) Registers 



Generated $MODEL files contain names for the otherwise unassigned registers (R0,R1,...,R15). The 
name for each register is its hexadecimal address (F0,F1,...,FF). If your program contains another name 
for one or more of these registers, only the Fx name will display in disassemblies. However, note that 
the variable names can still be accessed symbolically (e.g., in the "Display/ Alter | Var/Reg" pull-down). 

If you would rather see the variable names from your program in disassemblies, you can comment out 
those lines in the SMODEL file defining the Rn (Fx) registers. Do this by placing a comment character 
(pound-sign, "#") at the beginning of the A3 lines in the SMODEL file for those Rn (Fx) registers to 
be "eliminated". 

Alternatively, if you would also like to see such variable names from your program displayed in the 
Register Window as well as in disassemblies, don't comment out the A3 lines in the SMODEL file. 
Rather, change the register name (the quoted string) in the appropriate A3 directive(s) from "Fn" to 
"my_var", where my_var is the variable name from your program. 

Emulation Notes 



The following characteristics apply to all iceMASTER-COP8 emulators: 

1) If a Break-point is set on an instruction, emulation will not break until after that instruction 
executes. Note that Break-points are independent of Pass-count-points. 

2) If a Trace-On/Off-point is set on an instruction, tracing will be turned on/off immediately before 
the first cycle of that instruction. 

3) If a Pass-count-point is set on an instruction, the pass counter is decremented and tested after 
that instruction executes. When the pass counter has decremented to zero (0) a break will occur 
when the next Break-point is reached. 

4) 880 Probe Cards . Upon reaching a Break-point, the timer is shut off approximately 20 cycles after 
emulation stops. When emulation resumes, the timer is restarted approximately 16 cycles before 
emulation in the target application program actually begins. 

884rr/888xr Probe Cards . There is no delay in stopping or restarting running timers upon 
reaching a Break-point or when emulation resumes. 

5) If you are using HALT mode, in order to avoid possible synchronization problems, always place 
two NOP instructions following the HALT mode instruction. 
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MKSHF Utility 

The MKSHF.EXE ("MaKe Symbolic Hex File") utility program allows you to take maximum advan- 
tage of iceMASTER' s symbolic debugging capabilities. MKSHF merges the symbol file (.SYM) 
generated by the COP800 Assembler with the code (.HEX) file generated by National's LMHEX 
utility. The resultant file is in a format suitable for loading into the iceMASTER-COP8 system during a 
debugging session. 

MKSHF ignores the typing information present in the .SYM file. Only the symbol's name and value 
(address) are extracted. By default, unless told otherwise, MKSHF assumes that a symbol is a code 
label (i.e., relative to the code memory space). You can optionally provide MKSHF an input file 
containing a list of "exceptions". It is in this way that you can denote: 

1) the variable names (relative to the internal data memory space), 

2) the numbers ("equates" - relative to no memory space in particular), or 

3) those symbols which are to be totally ignored. 

A sample batch file for producing a symbolic hex file, loadable into iceMASTER, follows: 



rem File: DEMO C8.BAT 




rem 1 . 


Assemble to generate " . LM" , " . LST" and ".SYM": 




ASM8 


demo_c8.asm /O=demo c8.1m /L=demo c8.1st /S 




rem 2 . 


Convert " .LM" (load module) to ".HEX" (standard HEX) 




LMHEX 


demo c 8 . lm 




rem 3 . 


Create the Symbolic Hex File ( " . SHF" ) : 




rem 


Input: demo c8.sym (created by 1. above) 




rem 


Input: demo c8.exe (Exception File — created previously) 


rem 


Input: demo c8.hex (created by 2. above) 




rem 


Output: demo c8.shf 




MKSHF 


demo_c8.sym demo c8.exe demo c8.hex demo c8.shf 




rem 4 . 


Then, when you are using iceMASTER (ICE. EXE), select 


the 


rem 


"File, Load" pull-down command to load the file "demo 


_c8 . shf " 


rem 


into the emulator . 





The syntax for invoking MKSHF is: 

MKSHF <sym_in> <excep_in> <hex_in> <hex_out> 

where 



< symin > 

(input file) The ".SYM" symbol file generated by the COP800 Assembler. You must specify the 7S" 
option to the Assembler to create this file and you must be using "REV:E,22 JUN 90" (or later) of the 
Assembler. 



4 



1992 April 8 



< excep_in > 



(input file) This file contains the list of "exception symbols". If a particular symbol does not appear in 
this Exception File (and it does appear in the < sym in > ".SYM" file), that symbol will be treated as 
a code label. Each line in an Exception File should contain a symbol name followed by a single-digit 
code telling MKSHF how to treat the symbol: 



File Entry 


Meaning 


<sym> 2 


variable name 
(data memory label) 


<sym> 5 


number 

(not associated with any memory space in particular) 


j < sym > 9 


completely ignore this symbol 

(do not output it to the ".SHF" file) 



Once you create an Exception File for a particular application program, you needn't worry about 
changing that Exception File unless you add new data locations (variables) to your assembly language 
program and would like to access those variables symbolically in iceMASTER. 

If you do not want to supply an Exception File, you must specify the argument as a single dash ( — ). If 
you do this, all symbols in the < sym_in> (".SYM") file will be treated as code labels. 

To make it easier to create an Exception File, you can start with a copy of the supplied Exception File, 
"MKSHF.EXC". This file contains specifications for all symbols normally found in the standard 
COP800 Assembler include files (COPrtx.INC). Then, add the appropriate symbols in your assembly 
language program to that copy of MKSHF.EXC. If a symbol appears more than once in an Exception 
File, the last specification will be used. Thus, you should probably always add new symbols at the end 
of an Exception File. 

< hex_in > 

(input file) The ".HEX" file generated by LMHEX. 
<hex_out> 

(output file) The generated Symbolic Hex File (".SHF"). Note that the MKSHF program does not 
supply the ".SHF" file extension - whatever you want to use is fine. 
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iceMASTER-C0P8 Probe Cards 



All COP8 probe cards have the same basic layout as shown in Figure 1: 
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Figure 1. COP8 Probe Card 
Jumper Blocks The user-selectable jumper blocks on the probe card are: 



50-Pin Header 




W1 - SELECT 

The function of the SELECT Jumper depends on the probe card. The configuration of this jumper is 
readable by the iceMASTER host software and its setting can be verified by selecting the "Config- 
ure | Identification" pull-down menu. 

880 . The SELECT Jumper determines how much on-chip internal RAM is available; this allows you to 
emulate the 820, 820CJ and 840 devices, as well as the 880. When the shorting block is placed between 
the center post and the "A" post, 64 bytes of RAM can be used. When the shorting block is placed 
between the center post and the "B" post, 128 bytes of RAM are available. 

884xy/888xr . The SELECT Jumper allows the probe card to accurately emulate COP8 Mask Options. 
The Wl jumper controls the HALT Enable mask option. When the shorting block is placed between 
the center post and the "A" post, the HALT functionality of the microcontroller is disabled . When the 
shorting block is placed between the center post and the "B" post, the HALT functionality is enabled . 
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W2 - VCC 



The VCC Jumper is effective only on the 2.3V-6.0V and 2.5V-6.0V probe cards. This jumper allows 
the operating voltage of the probe card to be supplied from either the probe card (PC) or the target 
system (TAR). The PC setting supplies only 5.0V and is required for out-of-target emulation. The TAR 
setting uses the voltage supplied to the VCC pin of the microcontroller socket on the target system. 
This voltage may range anywhere from 2.3V to 6.0V or 2.5VDC to 6.0VDC depending on your probe 
card. 

On 4.5V-5.5V probe cards this jumper is hardwired to the PC setting. THIS MUST NOT BE 
CHANGED! OPERATING A 4.5V-5.5V PROBE CARD OUTSIDE THIS VOLTAGE RANGE MAY 
PERMANENTLY DAMAGE THE PROBE CARD. 

When operating a 2.3V-6.0V or 2.5V-6.0V probe card with a voltage source less than 4V, the maximum 
operating frequency must be reduced per the National Semiconductor specification for the particular 
part. Attempting to operate the probe card above that maximum frequency will cause unpredictable 
results. 

W3,W4 - XTAL 

The XTAL Jumpers allow the clock source (CKI) to be supplied from either the probe card (PC) or 
the target system (TAR). An oscillator circuit (see Miscellaneous Notes on page 8) is used on the probe 
card to emulate the oscillator circuit of the microcontroller. When the PC setting is selected, a 10MHz 
crystal is connected to the oscillator circuit. With this setting, G7 is still available to the target system 
as a general-purpose input. When the TAR setting is selected, either a target crystal or clock driver can 
be used. 



Oscillator Source 


W3 


W4 


Probe Card 


PC 


PC 


Target 


TAR 


TAR 



D1 - BROWN OUT 

The Dl LED indicates that the probe card processor is being run from a voltage source that is less than 
the Brown Out voltage for the probe card. The nominal Brown Out voltage is 2.34 VDC for the 820CJ 
probe card and 2.52 VDC for all other probe cards, with approximately 140 millivolts of hysteresis. This 
voltage level is due to the operating characteristics of the probe card and may differ from final 
production parts. Note that Brown Out is a feature of the probe card (not the device) and is therefore 
available on all probe cards. Currently, the only production part that incorporates Brown Out is the 
820CJ. ii I ta 



W6 - Brown Out Disable 



The W6 Jumper allows the user to emulate the Brown Out bondout option. When enabled, the Brown 
Out feature will be emulated. When disabled, the Brown Out feature will NOT be emulated. NOTE: 
the BROWN OUT indicator (the yellow LED on the probe card) will always light when a voltage lower 
than the Brown Out voltage is detected, regardless of the state of the W6 jumper. 



Brown Out 


. W6 


Disabled 


A 


Enabled 


B 



Of J. 



W7 - G7 Option 



The W7 Jumper allows the user to emulate the G7 bondout option of the target processor. When 
emulating CKO, the probe card oscillator is driven out the target G7 pin. When emulating the 
INPUT/HALT bond out option the target G7 pin is routed directly to the Probe card processors G7 
pin. When running with a target crystal W7 must be in the CKO (B) position. 



=-^-^— — 

G7 Option 


W7 


CKO 


B 


INPUT/HALT 


A 



Miscellaneous Probe Card Oscillator Circuit . Figure 2 is a schematic diagram of the oscillator circuit used on the 
Notes COP8 probe card. The circuit uses an inverter as a Pierce oscillator amplifier to simulate the amplifier 

of the microcontroller. 



TARGET CKI PIN 

Q 
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PC 



10OK 

74HCU04 



20pF 
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-OtOV > CHIP S7 PIH 



TAR X T A L 



-> PROBE XTAL »EF. 



Figure 2. COP8 Probe Card Oscillator 



8 



1992 April ! 



When W3 and W4 are jumpered to the "PC" setting, a 10MHz crystal is connected to the amplifier. 
The output of this circuit is buffered before driving the probe card's microcontroller CKI input. This 

allows the CKO/G7 pin to be available to the target system as the G7 input. 

■ 

When W3 and W4 are jumpered to the "TAR" setting, the target system may provide either a crystal 
or clock driver input. To verify that a target system crystal is operating correctly with the probe card 
amplifier, view the signal on pin 11 of the 68-lead PLCC device nearest the W3, W4 jumper blocks. Pin 
11 is the clock input to the microcontroller. The signal should be at the target crystal frequency with 
standard CMOS voltage levels. If the signal does not exhibit these characteristics, the resistor and 
capacitor values on the target system crystal circuit should be adjusted accordingly. 

888CF VREF and AGND Pins . The 888CF VREF and AGND signals are routed directly to the small 
adapter board pins (on the underside of the probe card) and are not connected to a source or ground 
on the probe card. As a result, when operating the probe card out of a target system (or in a target 
system without VREF and AGND), the I/ACH functionality of the 888CF microcontroller will not 
operate properly. 



Low Frequency Operation . At crystal speeds below 500KHz, the A49 directive in the $MODEL file 
may need to be increased from the default value of 6 to a new value around 20. This is dependent on 
the speed of the computer running the host software and the crystal speed in the target system. 
Common indications of a need to increase the timeout value will be inability to establish communica- 
tions with the iceMASTER base, or loss of communication after a break-point or host-break. The A49 
directive is approximately 550 lines down from the top in the $MODEL file. 
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